flutter-skill — Claude Code MCP server for code-free E2E tests
Hooks an AI agent into a running app so it can see the screen, tap buttons and type text. You describe the test in plain words.
claude mcp add flutter-skill -- npx -y flutter-skillWhat flutter-skill does
flutter-skill is an MCP server that opens a running app to an AI agent. The agent pulls an accessibility tree, takes screenshots, taps elements, types text, presses keys and runs JavaScript. No Page Objects, no XPath, no selectors that break on every layout change.
Install it globally with npm, then point your MCP client at it. Flutter apps need two lines: import package:flutter_skill/flutter_skill.dart and call FlutterSkillBinding.ensureInitialized() inside main(). There is also an HTTP mode — flutter-skill serve https://your-app.com starts a server, and CLI commands such as nav, snap, screenshot, tap and type act as a client. That path suits CI pipelines and scripts.
In server mode Chrome launches on its own; in serve mode the server attaches to a Chrome you already have open. No Chrome on the machine, or a non-standard launch setup, and the automatic start fails — check that first before blaming the test.
What it helps with
- walk every screen of an app and list the bugs
- run a checkout with an empty cart
- fill in a signup form and submit it
- capture a screenshot at a specific moment
- run JavaScript and read a value back from the DOM
Example prompts for the agent
- Launch my app, go through every screen and report any bugs you find
- Open the cart empty, add three items and finish the purchase
- Take an accessibility snapshot of the home page and show me which buttons it has
How to install flutter-skill
Platform CLI
claude mcp add flutter-skill -- npx -y flutter-skillPlatform CLI
codex mcp add flutter-skill -- npx -y flutter-skillConfig file
{
"mcpServers": {
"flutter-skill": {
"command": "npx",
"args": [
"-y",
"flutter-skill"
]
}
}
}Config file
{
"servers": {
"flutter-skill": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"flutter-skill"
]
}
}
}Platform CLI
gemini mcp add flutter-skill npx -y flutter-skillStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about flutter-skill
How do I install flutter-skill in Claude Code?
Run claude mcp add flutter-skill -- npx -y flutter-skill. That registers the server in your Claude config.
What does flutter-skill do?
It connects an AI agent to a running app over MCP. The agent sees the screen, taps elements, types text and takes screenshots, so you write no test code.
How is server mode different from serve?
server speaks MCP over stdio and starts Chrome itself, which fits IDE and agent use. serve exposes HTTP and attaches to an existing Chrome, which fits CLI, CI and remote access.
