Skip to content
pubscout

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.

WASM-ready
$ flutter pub add marionette_flutter
Source repository

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.

Works with

Packages commonly used together with marionette_flutter: ones it builds on, ones built on it, and its own family.