mcp_flutter

Overview

This is a Dart-based MCP server and Flutter toolkit that enables AI assistants to interact with running Flutter applications. It provides 27 MCP tools under the 'fmt_*' prefix for app inspection, interaction, debugging, and lifecycle management. A key feature is the ability to dynamically register custom tools and resources at runtime, creating a closed feedback loop between AI agents and Flutter apps.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• fmt_list_client_tools_and_resources

  List all client tools and resources available in the Flutter app

  Try:Show me all available toolsTry:List all Flutter resources
• fmt_hot_reload

  Trigger a hot reload of the Flutter app

  Try:Hot reload the appTry:Apply changes without restart
• fmt_hot_restart

  Trigger a hot restart of the Flutter app

  Try:Restart the appTry:Fully reload the application
• fmt_semantic_snapshot

  Take a semantic snapshot of the Flutter app's UI

  Try:Show me the current UI structureTry:Describe what's on screen
• fmt_tap_widget

  Tap on a specific widget in the Flutter app

  Try:Tap the login buttonTry:Press the submit button
• fmt_type_into_text_field

  Type text into a specific text field in the Flutter app

  Try:Enter my name in the first fieldTry:Type 'test@example.com' in the email field
• fmt_scroll

  Scroll the Flutter app view in a specific direction

  Try:Scroll downTry:Scroll to the top of the list
• fmt_screenshot

  Take a screenshot of the current Flutter app view

  Try:Capture the current screenTry:Take a picture of what's displayed
• fmt_get_recent_logs

  Retrieve recent logs from the Flutter app

  Try:Show me the latest logsTry:What errors have occurred recently?
• fmt_evaluate_dart_expression

  Evaluate a Dart expression in the Flutter app context

  Try:Evaluate 1+1 in the app contextTry:Check the value of counterVariable
• fmt_navigate_to_route

  Navigate to a specific route in the Flutter app

  Try:Go to the home screenTry:Navigate to the profile page
• fmt_wait_for_condition

  Wait for a specific condition to be met in the Flutter app

  Try:Wait for the loading spinner to disappearTry:Wait until the button is enabled

Comparable tools

Installation

curl -fsSL https://raw.githubusercontent.com/Arenukvern/mcp_flutter/main/install.sh | bash

cd my-flutter-app
flutter-mcp-toolkit codegen-init   # adds flutter_mcp_toolkit + emits main.dart snippet

flutter-mcp-toolkit init claude-code   # or: cursor | codex | cline | all

flutter run --debug

{
  "mcpServers": {
    "flutter-mcp-toolkit": {
      "command": "flutter-mcp-toolkit",
      "args": ["server"]
    }
  }
}

FAQ

How do I connect the MCP server to my Flutter app?

Ensure your Flutter app is running in debug mode. The toolkit provides a WebSocket connection that the MCP server can connect to. You can find the connection URI in your Flutter app's debug output.

Can I create custom MCP tools for my Flutter app?

Yes, the toolkit supports dynamic tool registration at runtime. You can add custom tools using `MCPToolkitBinding.instance.addEntries()` in your Flutter app.

Which AI assistants are supported?

The toolkit supports Claude Code, Cursor, Codex, Zed, Intent, Cline, and other compatible AI assistants that can connect to MCP servers.

Compare mcp_flutter with