Agent skill

Flutter MCP

by Arenukvern in Arenukvern/mcp_flutter

A skill your agent uses whenever inspecting, interacting with, or live-editing a running Flutter app via the Flutter MCP toolkit server (mcpServers key flutter-mcp-toolkit, or legacy…

MITAuto-check passedMobile

Install Flutter MCP

skills CLI
$ npx skills add Arenukvern/mcp_flutter --skill flutter-mcp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Arenukvern/mcp_flutter flutter-mcp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Arenukvern/mcp_flutter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugin/skills/flutter-mcp .claude/skills/flutter-mcp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
flutter-mcp
GitHub stars
386
Token cost
~1.3k tokens
SKILL.md length
524 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses whenever inspecting, interacting with, or live-editing a running Flutter app via the Flutter MCP toolkit server (mcpServers key flutter-mcp-toolkit, or legacy…

  • Works in 2 steps: Call doctor (or run flutter-mcp-toolkit… → Confirm required toolkit extensions…
  • Interacting with
  • SKILL.md covers When to use, Preflight (always first), Tool naming (v3.0.0+) and Interaction loop…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Flutter MCP is an agent skill from Arenukvern/mcp_flutter. Use this skill whenever inspecting, interacting with, or live-editing a running Flutter app via the Flutter MCP toolkit server (mcpServers key flutter-mcp-toolkit, or legacy flutter-inspector). Covers preflight, snapshot/tap/enter/scroll loop, hot-reload validation, and error envelope parsing.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering Cross-platform mobile apps and MCP servers. It works with Flutter and Model Context Protocol. The repository describes itself as: MCP Toolkit for Flutter AI Agent Driven Development (MCP/CLI + custom client side tools) - via closed feedback loop (visual & semantic snapshot) and high client side… The licence is MIT.

When your agent uses it

  • Interacting with
  • Live-editing a running Flutter app via the Flutter MCP toolkit server (mcpServers key flutter-mcp-toolkit
  • Legacy flutter-inspector)

Example prompts

  • “/flutter-mcp”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Call doctor (or run flutter-mcp-toolkit doctor --json) — parses env, ports, app reachability.
  2. Confirm required toolkit extensions exist on the target

What it can do on your machine

Read from SKILL.md and the folder at commit 62f3ee1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Flutter MCP loads about 1.3k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 524 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Arenukvern/mcp_flutter at commit 62f3ee1, republished under its MIT licence (© Arenukvern). 524 words, ~1,299 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-mcp/SKILL.md (or your agent's skills folder).
name
flutter-mcp
description
Use this skill whenever inspecting, interacting with, or live-editing a running Flutter app via the Flutter MCP toolkit server (`mcpServers` key **`flutter-mcp-toolkit`**, or legacy **`flutter-inspector`**). Covers preflight, snapshot/tap/enter/scroll loop, hot-reload validation, and error envelope parsing.
<!-- @FMT_MODE_PRELUDE -->

Flutter MCP

Golden path for agents driving a live Flutter app via the flutter-mcp-toolkit MCP server entry. Older configs may use the legacy flutter-inspector mcpServers registry id for the same binary (that id is not the Claude subagent flutter-mcp-toolkit-runtime).

When to use

  • User references a running Flutter app (debug mode) and wants to inspect, screenshot, interact with, or hot-reload it.
  • User pastes a VM service URI (ws://127.0.0.1:8181/.../ws) or mentions port 8181.
  • You need runtime proof (before/after screenshots) that a code edit took effect.

Preflight (always first)

Before any VM-dependent call:

  1. Call doctor (or run flutter-mcp-toolkit doctor --json) — parses env, ports, app reachability.
  2. Confirm required toolkit extensions exist on the target:
    • ext.mcp.toolkit.app_errors
    • ext.mcp.toolkit.view_details
    • ext.mcp.toolkit.view_screenshots
    • ext.mcp.toolkit.inspect_widget_at_point

If missing, stop and report the instrumentation gap — do not guess:

  • Add mcp_toolkit to pubspec.yaml.
  • Ensure MCPToolkitBinding.instance..initialize()..initializeFlutterToolkit(); runs before runApp.
  • Hot restart (not reload) — reload is often insufficient for extension registration.

Tool naming (v3.0.0+)

All MCP tools surface under the fmt_ capability prefix (fmt_tap_widget, fmt_hot_reload_and_capture, etc.). The prefix is mandatory in tools/call. Skill-local references below use the bare name for readability — when invoking, prepend fmt_. Dynamic-registry host tools (fmt_list_client_tools_and_resources, fmt_client_tool, fmt_client_resource) use the same prefix for a single consistent surface.

Interaction loop (Playwright-style)

  1. fmt_semantic_snapshot → returns s_0..s_N refs + snapshot_id.
  2. fmt_tap_widget / fmt_enter_text / fmt_scroll / fmt_swipe / fmt_long_press / fmt_drag — act on a ref. Always pass snapshotId — you get a structured stale_snapshot error if the tree moved, instead of a silent wrong tap.
  3. fmt_reveal_search — for off-screen semantic targets, bounded snapshot/search/scroll that returns a fresh ref + snapshotId.
  4. fmt_evaluate_dart_expression — read state directly (e.g. AgentState.instance.counter).
  5. fmt_hot_reload_and_capture — after a code edit, returns reload status + screenshot + fresh snapshot + errors in one response. Prefer this over manual reload + separate capture.
Show full SKILL.md (245 more words)Show less

Error envelope contract

Errors are {code, message, details, descriptor, recovery}. Parse error.descriptor (not the top-level object) for the machine-readable shape. Strict schemas default to additionalProperties: false — unknown params reject.

Common codes and recovery:

  • connection_selection_required — retry with arguments.connection.targetId or exact arguments.connection.uri from app.debugPort.wsUri.
  • target_not_found — refresh targets, then prefer exact arguments.connection.uri.
  • stale_snapshot — call fmt_semantic_snapshot again, then retry the action with the new snapshotId input.
  • tool_not_found — confirm the prefixed name (fmt_<tool>); v3.0.0 dropped legacy unprefixed names.
  • Empty screenshot output — verify the server was not started with --no-images.
  • Missing view resource/tool — verify the server was not started with --no-resources.

Visual QA

  • Before/after screenshots are the proof artifact for any UI claim. Capture before with fmt_capture_ui_snapshot (or one of the visual://localhost/... resources), edit, fmt_hot_reload_and_capture, compare.
  • For each reported visual issue, attach coordinate + fmt_inspect_widget_at_point output.
  • Map defects to source via fmt_get_app_errors top stack frame (file, line, column) when available.
  • Do not use fmt_debug_dump_* unless explicitly requested (server must be started with --dumps; high token cost).

Permissions (macOS)

Screen Recording permission belongs to the process running flutter-mcp-toolkit (or the MCP server host). If visual capture is denied:

bash
flutter-mcp-toolkit permissions status
flutter-mcp-toolkit permissions request
flutter-mcp-toolkit permissions open-settings

Non-modifiable apps

If the target app cannot be instrumented (third-party binary, restricted env), report flutter-mcp as unavailable for that app. Do not claim screenshot/layout/error inspection success.

  • For the dynamic-tools side (registering custom MCP tools from inside the Flutter app), see the flutter-mcp-toolkit-custom-tools skill.
  • For routing across setup / inspect / control / debug skills, see flutter-mcp-toolkit-guide.
  • For repeatable scenarios as checked-in Dart (build/launch/attach/drive/assert without MCP), see flutter-mcp-e2e-harness.

© Arenukvern, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugin/skills/flutter-mcp of Arenukvern/mcp_flutter.

Open the folder on GitHubat commit 62f3ee1

Compare with similar skills

Flutter MCP next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Flutter MCP compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter MCP this skillArenukvern/mcp_flutter386—~1.3kAutomated safety check: PassMIT
Retrieving Developer Knowledgegoogle/skills21k—~2kAutomated safety check: PassApache-2.0
MCP Dart Clientleehack/mcp_dart116—~1.8kAutomated safety check: PassMIT
Appllama UsageAppllama/appllama-skills2.5k1 repos~1.6kAutomated safety check: PassMIT
Marionette Flutter Drive Appleancodepl/marionette_mcp482—~11kAutomated safety check: PassApache-2.0
Aaalice Dev SessionsAaalice233/Aaalice_NAI_Launcher188—~902Automated safety check: PassMIT

Similar skills

  • Official

    Searches, retrieves, and synthesizes official Google developer documentation across Google Cloud, AI/Gemini, Android, Chrome, Web, Flutter, Go, Firebase, and other Google developer platforms.

    21k GitHub stars~2k tokensUpdated today
    Backend & APIsAuto-check passed
  • MCP Dart Client

    leehack/mcp_dart

    A skill your agent uses when connecting a Dart or Flutter app to a Model Context Protocol (MCP) server with mcpdart: creating an McpClient, launching a local server over stdio or reaching a remote…

    116 GitHub stars~1.8k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Appllama Usage

    Appllama/appllama-skills

    Use the Appllama MCP (mcp.appllama.io) well — research real top-grossing mobile apps, their screens, flows, and UI elements, then build from what you learn.

    2.5k GitHub starsUsed in 1 repo~1.6k tokens
    MobileAuto-check passed
  • Marionette Flutter Drive App

    leancodepl/marionette_mcp

    Set up and drive a running Flutter app (debug or profile) with Marionette — an AI agent's hands and eyes for the app.

    482 GitHub stars~11k tokensUpdated 3 days ago
    MobileAuto-check passed
  • Aaalice Dev Sessions

    Aaalice233/Aaalice_NAI_Launcher

    管理 Aaalice NAI Launcher 项目专用的 Windows 与 Android Flutter 开发会话。用户提到 PC热重载、安卓热重载、启动/关闭/重建独立命令行窗口、模拟器启动异常或检查双端会话时使用。

    188 GitHub stars~902 tokensUpdated 4 days ago
    MobileAuto-check passed
  • AI App Bridge Use

    mobileAiDev/ai-app-bridge

    使用 AI App Bridge 观察、操作和验证 Android、iOS、Flutter、WebView 或 Web App;适用于真实交互、流程自动化和设备诊断。

    227 GitHub stars~1.4k tokensUpdated yesterday
    MobileAuto-check passed

More from Arenukvern/mcp_flutter

All 23 skills in this repo
  • Harness Engineering Lifecycle

    Arenukvern/mcp_flutter

    Design, implement, and integrate generalized validation harnesses across a producer-consumer boundary after a local harness contract exists.

    386 GitHub stars~1.6k tokensUpdated 6 days ago
    Auto-check passed
  • Mixture Of Experts

    Arenukvern/mcp_flutter

    Run a Mixture of Experts (MoE) audit on any topic, plan, codebase, evidence archive, or process.

    386 GitHub stars~2.3k tokensUpdated 6 days ago
    Auto-check passed
  • Multi Agent Handoff

    Arenukvern/mcp_flutter

    Plan and document handoffs, parent lane contracts, and parallel batch contracts between specialized AI agents (foreman, workers, reviewers).

    386 GitHub stars~2.7k tokensUpdated 6 days ago
    Auto-check passed
  • Plugin Marketplace Setup

    Arenukvern/mcp_flutter

    Designs public or private Agent Skill and plugin marketplaces for Cursor, Claude Code, Codex, Zed, Open Plugin, and npx skills—manifest layout, install matrix, and Skill Steward vs product boundaries.

    386 GitHub stars~2.9k tokensUpdated 6 days ago
    Auto-check passed
  • Release Changelog Harness

    Arenukvern/mcp_flutter

    Chooses ecosystem-native release and changelog tooling (Changesets, Melos, release-plz) plus binary distribution (GitHub Release tarballs, install.sh) when the product is an executable.

    386 GitHub stars~2.6k tokensUpdated 6 days ago
    Auto-check passed
  • Repository Governance Lifecycle

    Arenukvern/mcp_flutter

    Master orchestration for repository governance, North Star impact, sub-Star boundaries, and repair-first or evidence-first drift checks.

    386 GitHub stars~1.5k tokensUpdated 6 days ago
    Auto-check passed

Categories

Questions about Flutter MCP

What does Flutter MCP do?

A skill your agent uses whenever inspecting, interacting with, or live-editing a running Flutter app via the Flutter MCP toolkit server (mcpServers key flutter-mcp-toolkit, or legacy…. Flutter MCP is an agent skill from Arenukvern/mcp_flutter. Use this skill whenever inspecting, interacting with, or live-editing a running Flutter app via the Flutter MCP toolkit server (mcpServers key flutter-mcp-toolkit, or legacy flutter-inspector).

When should I use Flutter MCP?

Flutter MCP fits situations like: interacting with; live-editing a running Flutter app via the Flutter MCP toolkit server (mcpServers key flutter-mcp-toolkit; legacy flutter-inspector).

How do I install Flutter MCP in Claude Code?

Run `npx skills add Arenukvern/mcp_flutter --skill flutter-mcp -a claude-code`. Or copy the skill folder (plugin/skills/flutter-mcp in Arenukvern/mcp_flutter) into .claude/skills/flutter-mcp in your project. Claude Code loads it when a task matches its description.

How do I install Flutter MCP in Codex?

Run `npx skills add Arenukvern/mcp_flutter --skill flutter-mcp -a codex`. Or copy the skill folder (plugin/skills/flutter-mcp in Arenukvern/mcp_flutter) into .agents/skills/flutter-mcp in your project. Codex loads it when a task matches its description.

Can I use Flutter MCP in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Arenukvern/mcp_flutter --skill flutter-mcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flutter-mcp, .gemini/skills/flutter-mcp, .github/skills/flutter-mcp and .opencode/skills/flutter-mcp in your project.

What does Flutter MCP need to run?

SKILL.md names no scripts, command-line tools or credentials: Flutter MCP is instructions for the agent only.

Does Flutter MCP access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Flutter MCP safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Flutter MCP use?

Flutter MCP is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flutter MCP use?

About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Flutter MCP?

Skills that share tags, products or a category with Flutter MCP: Retrieving Developer Knowledge (google/skills, 21k stars), MCP Dart Client (leehack/mcp_dart, 116 stars), Appllama Usage (Appllama/appllama-skills, 2.5k stars) and Marionette Flutter Drive App (leancodepl/marionette_mcp, 482 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter MCP?

Arenukvern (a GitHub user) maintains it in Arenukvern/mcp_flutter, which has 386 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 3, 2026.

Source: Arenukvern/mcp_flutter on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.