# Flutter MCP Toolkit

> Flutter MCP Toolkit is an open-source MCP server for developer tools. Let an AI assistant inspect, tap through and hot reload a running Flutter debug app. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS
- **Website:** https://docs.page/arenukvern/mcp_flutter
- **Repository:** https://github.com/arenukvern/mcp_flutter/tree/HEAD/mcp_server_dart
- **MCP Registry name:** io.github.Arenukvern/flutter-mcp-toolkit
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

This server connects a Flutter app running in debug mode to an assistant so it can check changes against runtime evidence instead of guessing. After adding the `mcp_toolkit` package and bootstrapping it in the app, the assistant can capture screenshots, read app errors, dump layer, semantics, render and focus trees, hot reload or restart, and evaluate Dart expressions.

Interaction follows a Playwright-style model: take a semantic snapshot, then pass a ref such as `s_N` to tools that tap, long press, enter text, scroll, swipe or drag. A reveal_search helper scrolls to find off-screen targets, and a fused hot-reload-and-capture command returns a screenshot, fresh snapshot and errors in one call. Apps can register their own tools and resources at runtime through a dynamic registry.

Tool names in v3 carry an `fmt_` prefix. The same core backs a CLI (`flutter-mcp-toolkit`, alias `fmtk`) with validate-runtime, doctor, snapshot and bundle commands, and an explicit target id avoids mix-ups when several debug apps run. The server ships as an OCI image over stdio.

## Features

- **Semantic snapshots:** Captures the UI tree so interaction tools can target elements by ref.
- **UI interaction:** Tap, long press, type, scroll, swipe and drag on the running app.
- **Hot reload with capture:** Reloads and returns a screenshot, snapshot and errors together.
- **Runtime diagnostics:** Reads app errors and dumps layer, semantics, render and focus trees.
- **Dynamic app tools:** Your app registers custom MCP tools and resources at runtime.
- **Multi-target safety:** An explicit target id selects the app when several debug apps run.

## Good for

- Verify a UI fix on a live Flutter app
- Reproduce a bug by driving the screen from an assistant
- Read runtime errors after a hot reload
- Expose app-specific actions as tools for an agent
- Run scripted E2E checks from the CLI

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "flutter-mcp-toolkit": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/arenukvern/flutter-mcp-toolkit:7.1.1"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `fmt_tap_widget`: Tap a widget by snapshot ref.
- `fmt_hot_reload_and_capture`: Hot reload and return a screenshot, fresh snapshot and errors.
- `fmt_list_client_tools_and_resources`: List tools and resources the app registered at runtime.
- `fmt_client_tool`: Call an app-registered tool.
- `fmt_client_resource`: Read an app-registered resource.

## FAQ

### Does it work with release builds?

The docs describe debug apps; it connects to a running Flutter debug app.

### What is the tool prefix?

In v3 MCP tool names start with fmt_, for example fmt_tap_widget.

### Is there a command line?

Yes, flutter-mcp-toolkit with the short alias fmtk, including validate-runtime and doctor.

### How do I install it?

Add mcp_toolkit to the app and run the server from its OCI image over stdio.

### Is Flutter MCP Toolkit free?

Yes. Flutter MCP Toolkit is open source, so you can use and self-host it for free.

### How do I add Flutter MCP Toolkit to Claude Code?

Run this command in your terminal: claude mcp add flutter-mcp-toolkit -- docker run -i --rm ghcr.io/arenukvern/flutter-mcp-toolkit:7.1.1

### What are the best alternatives to Flutter MCP Toolkit?

The closest alternatives to Flutter MCP Toolkit are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/flutter-mcp-toolkit
