Android Tools MCP

An Android Studio plugin that exposes the built-in Gemini agent tools as an MCP server — so any AI coding tool can use them.

[!WARNING] This plugin uses undocumented internal APIs from Android Studio's Gemini plugin. These APIs can change or break at any time without notice. It is not affiliated with or endorsed by Google. Use at your own risk — best suited for experimentation and personal workflows, not production CI pipelines.

[!NOTE] Requires Android Studio Panda 2025.3.+ with the Gemini plugin enabled (bundled by default) and Python 3.7+ for the bridge script.

Quick start

1. Install the plugin

Download the ZIP from Releases and install via Settings → Plugins → Install Plugin from Disk in Android Studio.

2. Download the bridge script

Save android-studio-mcp.py somewhere on your machine.

3. Connect to your favourite tool (see below)

4. Open an Android project in Android Studio — the MCP server starts automatically.

Connect to your favourite tool

[!IMPORTANT] Always use absolute paths (e.g., /Users/you/android-studio-mcp.py), not ~. Most MCP clients don't expand the tilde.

Claude Code

claude mcp add android-studio -- python3 /absolute/path/to/android-studio-mcp.py

GitHub Copilot

Add to .vscode/mcp.json (or user-level settings.json under github.copilot.mcp):

{
  "servers": {
    "android-studio": {
      "type": "stdio",
      "command": "python3",
      "args": ["/absolute/path/to/android-studio-mcp.py"]
    }
  }
}

Kilo Code

Add to ~/.config/kilo/kilo.jsonc:

{
  "mcp": {
    "android-studio": {
      "type": "local",
      "command": ["python3", "/absolute/path/to/android-studio-mcp.py"],
      "enabled": true
    }
  }
}

OpenCode

Add to ~/.config/opencode/opencode.json:

{
  "mcp": {
    "android-studio": {
      "type": "local",
      "command": ["python3", "/absolute/path/to/android-studio-mcp.py"],
      "enabled": true
    }
  }
}

SSE-native clients

Any MCP client that supports SSE transport can connect directly — no bridge script needed:

http://127.0.0.1:24601/sse

Available tools (20)

All tools are Android-specific. Generic file/code tools are intentionally excluded. Tools are discovered dynamically from the Gemini plugin at runtime — when Android Studio updates with new tools, they appear automatically.

Custom port

By default the server runs on port 24601. To change it:

1. In Android Studio: Help → Edit Custom VM Options → add -Dmcp.bridge.port=12345
2. Pass --port 12345 to the bridge script

Build from source

git clone https://github.com/amsavarthan/android-tools-mcp
cd android-tools-mcp
./gradlew buildPlugin

The plugin ZIP is written to build/distributions/. The build compiles against your local Android Studio installation — set the path via local.properties (android.studio.path=...), env var ANDROID_STUDIO_PATH, or it defaults to /Applications/Android Studio.app.

Troubleshooting

License

Apache 2.0