BACK TO MCP SERVERS
dev-toolsany

Flutter MCP Toolkit

Inspect and drive Flutter debug apps/games: semantic snapshots, search, and custom client tools

At a glance

Not tested yet
GitHub stars
398
Last commit
2026-11-18
Licence
MIT
Transport
stdio
Auth
none
Install
docker run -i --rm ghcr.io/arenukvern/flutter-mcp-toolkit:7.2.1
Stats checked 2026-11-19

What it does

Flutter MCP Toolkit is a Dart MCP server plus the mcp_toolkit Flutter package. It lets an AI assistant inspect and drive a running Flutter debug app over the VM service. The agent can read UI state, act like a user, hot-reload, and call custom tools the app registers at runtime. It is for Flutter developers who want an agent to work against a live debug app rather than guess.

flutter-mcp-toolkit logo
Image: arenukvern/mcp_flutter (MIT)

Key features

  • Discover a running debug app and connect to it.
  • Read semantic UI snapshots and errors.
  • Tap, type, and scroll in the app.
  • Hot-reload the app.
  • Capture screenshots through the Flutter render pipeline.
  • Call custom tools your app registers at runtime.

Quick start

Install the server and CLI on your PATH with the install script:

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

Instrument your app, then paste the main() snippet before runApp:

cd my_flutter_app && flutter-mcp-toolkit codegen-init

Run the app in debug mode and verify the setup:

flutter run --debug
flutter-mcp-toolkit doctor

Add it to Claude Code from a terminal:

claude mcp add flutter-mcp-toolkit -- docker run -i --rm ghcr.io/arenukvern/flutter-mcp-toolkit:7.2.1

Or add this to .mcp.json in your project root (Claude Code) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "flutter-mcp-toolkit": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/arenukvern/flutter-mcp-toolkit:7.2.1"
      ]
    }
  }
}

Environment variables

The registry entry declares no environment variables.

Example prompts

  • Discover debug Flutter apps, connect, and return a semantic snapshot.
  • Tap the login button and tell me what the screen shows next.
  • Hot-reload the app and check for errors.
  • Take a screenshot of the current screen.

What to watch out for

  • Debug-mode only by design. It does not work with release builds or when there is no debug VM.
  • If you only need static analysis, the README points to Dart MCP or CI instead.
  • Release binaries support macOS Apple Silicon and Linux x64. Intel macOS is deprecated.
  • The server binary is distributed through GitHub Releases, not pub.dev.
  • The Smithery listing is currently unavailable (404 as of 2026-11); use the official MCP Registry or marketplace install.

Not tested by tools4agents yet. Read the source repository before you install it.

GitHub SourceGitHub Stars
Last verified 2026-11-19

Similar tools