PACKAGE EXPLORERView in registry

agi-android-mcp

PyPI

Control any Android phone from Claude, Cursor, or any MCP client — via ADB

Versions collected1

Direct dependencies1From release 0.0.1

Last observed21 Oct, 09:04 UTC

README

Version 0.0.1 documentation

agi-android-mcp

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

Demo

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)

Tool	Description
`screenshot`	Take a screenshot, returned as PNG image
`get_screen_size`	Get screen dimensions in pixels
`tap(x, y)`	Tap at pixel coordinates
`double_tap(x, y)`	Double-tap at pixel coordinates
`long_press(x, y)`	Long-press at pixel coordinates
`type_text(text)`	Type text into focused input field
`press_key(key)`	Press a key (enter, backspace, tab, space, home, back)
`swipe(direction)`	Swipe up/down/left/right from screen center
`drag(start, end)`	Drag between two points
`press_home()`	Press the Home button
`press_back()`	Press the Back button
`open_notifications()`	Open the notification shade
`open_quick_settings()`	Open quick settings panel
`launch_app(package)`	Launch an app by package name
`get_current_app()`	Get the currently visible app/activity
`list_installed_apps()`	List installed packages
`shell(command)`	Run any ADB shell command
`get_device_info()`	Get device model, Android version, screen size, battery

Environment Variables

Variable	Default	Description
`ADB_PATH`	Auto-detected	Path to `adb` binary
`ADB_SERIAL`	(none)	Target a specific device by serial number

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

MCP server starts over stdio (standard MCP transport)
When a tool is called, it translates to an adb subprocess call
Screenshots: adb exec-out screencap -p
Input: adb shell input tap/swipe/text/keyevent
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

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases

Version	Published	Direct dependencies	Open version
0.0.1	16 Feb 2026	1

Package advisories

No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING

agi-inc/agi-android-mcp

Shared repository data · GitHub

License detected in repository: Not collected

Metadata history

Meaningful changes

Current collected state Current

Observed since 21 Oct, 09:04 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:636b597b3ef3dc25955834b24cdca4ace7d7397679c2fd8e4b1e7099735c9ae3