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
docker run -i --rm ghcr.io/arenukvern/flutter-mcp-toolkit:7.2.1
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.

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.
Similar tools
Everything
The official test server. Exercises every part of the protocol, so it is the fastest way to check your setup works at all.
Filesystem
Gives an agent scoped read and write access to directories you name explicitly. The usual first MCP server people install.
Git
Read, search, and manipulate local Git repositories. Lets an agent inspect history and diffs without shelling out.
Sequential Thinking
Gives a model a scratchpad for multi step reasoning, letting it revise earlier steps instead of committing to a first answer.