agi-android-mcp

Control any Android phone from Claude Code, Cursor, or any MCP client — just ADB, no app required.

How it works

Claude Code  ──(MCP stdio)──►  agi-android-mcp  ──(ADB)──►  Android Phone

A lightweight Python MCP server that translates tool calls into adb commands. Works with any Android phone that has USB debugging enabled. No proprietary dependencies.

Quick Start

1. Install

pip install agi-android-mcp

2. Plug in your phone

Enable USB debugging (Settings > Developer options > USB debugging), connect via USB, and verify:

adb devices
# emulator-5554    device

3. Add to Claude Code

Add to ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "android": {
      "command": "agi-android-mcp"
    }
  }
}

Restart Claude Code. That's it. Tell Claude:

"Take a screenshot of my phone"

"Open Chrome and search for the weather"

"Launch Settings and turn on dark mode"

Claude will take screenshots, reason about the UI, and tap/type/swipe to accomplish the task.

Add to Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "android": {
      "command": "agi-android-mcp"
    }
  }
}

Any MCP client

The server uses stdio transport. Run agi-android-mcp as the command — it speaks MCP over stdin/stdout.

Tools (18)

Environment Variables

Multiple devices? Set ADB_SERIAL:

{
  "mcpServers": {
    "android": {
      "command": "agi-android-mcp",
      "env": {
        "ADB_SERIAL": "XXXXXXXXXXXXXX"
      }
    }
  }
}

Agentic Demo

demo.py runs a full autonomous loop: screenshot → Claude reasons → execute action → repeat.

pip install anthropic
ANTHROPIC_API_KEY=sk-... python demo.py "Open Chrome and search for cats"

How It Works

1. MCP server starts over stdio (standard MCP transport)
2. When a tool is called, it translates to an adb subprocess call
3. Screenshots: adb exec-out screencap -p
4. Input: adb shell input tap/swipe/text/keyevent
5. Apps: adb shell am, adb shell pm

Development

pip install -e .
python -c "from agi_android_mcp.server import mcp; print(len(mcp._tool_manager._tools), 'tools')"

License

MIT