marionette_flutter
0.7.0, released 7 weeks ago by leancode.co
Flutter extensions for AI agent interaction via MCP to test and drive running apps.
What it does
Enables AI agents like Claude, Copilot, and Cursor to inspect, tap, scroll, type, and screenshot running Flutter applications using the Model Context Protocol (MCP). Connects the AI directly to the running app to facilitate automated AI-driven interaction and smoke testing.
AI-written summary of version 0.7.0, based on the package's README and metadata. Report an inaccuracy
Use it when
- You want AI agents to interact with, test, or drive your running Flutter application.
- You want to automate UI smoke tests using natural language prompts in tools like Claude Code or Cursor.
Skip it when
- You are looking for traditional code-only unit or widget testing without AI interaction.
- Your app runs completely disconnected from a debugging service where the MCP bridge cannot connect.
Strengths
- Connects AI agents directly to running applications for runtime interaction and testing.
- Exposes a compact and focused toolset that keeps context sizes under control.
- Supports custom extensions to expose app-specific actions as agent tools.
Weaknesses
- Requires custom design system setup if not using standard Material widgets.
- Requires the app to run in debug mode with an active VM service URI.
Setup
- Kind
- Flutter widgets
- Effort
- Low
- Code generation
- No
- Direct dependencies
- 2
Add marionette_flutter as a dependency, initialize MarionetteBinding in main.dart under debug mode, install the marionette_mcp bridge, and configure your AI tool.
void main() {
if (kDebugMode) {
MarionetteBinding.ensureInitialized();
} else {
WidgetsFlutterBinding.ensureInitialized();
}
runApp(const MyApp());
}Alternatives
Packages that do the same job and could replace marionette_flutter.
- patrol_mcp
Alternative integration testing and MCP tool for Flutter applications.
87Compare
Works with
Packages commonly used together with marionette_flutter: ones it builds on, ones built on it, and its own family.