English Français العربية

AndroidMCP Framework

Official registry Other

MCP server and CLI for Android development and change-aware Android and Flutter testing workflows.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package androidmcp-framework
Claude Code 
claude mcp add androidmcp-framework -- npx -y androidmcp-framework@0.1.12 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "androidmcp-framework": {
            "command": "npx",
            "args": [
                "-y",
                "androidmcp-framework@0.1.12",
                "mcp"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. AndroidMCP Framework
  2. Install
  3. Connect an MCP client
  4. Initialize an app project
  5. Local checkout config
  6. How it's built
  7. Development
  8. Testing framework
  9. License

AndroidMCP Framework

A Model Context Protocol (MCP) server and CLI that gives coding agents Android development capabilities: build, install, and launch on emulators and physical devices; semantic UI automation; logcat/crash diagnostics; project discovery; change-aware testing intelligence.

66 tools across 12 workflows. Five are enabled by default (device, ui-automation, session-management, doctor, workflow-discovery); the rest are opt-in - see workflow docs.

Install

npm install -g androidmcp-framework@latest
androidmcp-framework doctor

Or run on demand with no global install: npx -y androidmcp-framework@latest mcp.

Connect an MCP client

{
  "mcpServers": {
    "androidmcp-framework": {
      "command": "npx",
      "args": ["-y", "androidmcp-framework@latest", "mcp"]
    }
  }
}

See coding agent setup for Claude Code, Codex, Gemini CLI, Antigravity, and VS Code/GitHub Copilot instructions. Android Studio's documented MCP client requires HTTP, while this server currently exposes stdio only; see supported clients.

Initialize an app project

From the Android or Flutter repository root:

androidmcp-framework setup

This creates .androidmcp-framework/config.yaml. If existing data remains under .android-build-mcp/ or .androidbuildmcp/, inspect it and run androidmcp-framework setup --migrate to copy files without overwriting existing content. The old directory is not deleted automatically.

All project-specific framework data is kept inside .androidmcp-framework/. Screenshots, saved UI hierarchy JSON, screen recordings, and bug-report archives are organized under .androidmcp-framework/artifacts/; test-case definitions and timestamped test reports remain in their dedicated testcases/ and test-reports/ directories. Generated artifacts are local outputs and are ignored by Git by default.

Local checkout config

Build with npm ci && npm run build, then configure the MCP client to launch the built entry point build/cli/index.js mcp. Use an absolute path to your own checkout; do not copy machine-specific paths from examples.

How it's built

  • UI automation: JavaScript/TypeScript plus Android SDK platform-tools (adb) only. The optional Python uiautomator2 bridge has been removed; no Python runtime or scripts/ directory is required.
  • Device targeting: emulators and physical devices are unified through ADB. Explicit target, session default, then single connected target are tried in that order.
  • MCP transport: stdio for local coding agents. Streamable HTTP is not implemented yet.
  • Tools: one TypeScript module per tool under src/tools/<workflow>/.

Development

npm ci
npm run build
npm run typecheck
npm test

TypeScript compiles from src/ to generated build/. Do not commit generated build/ or stale dist/ output.

Testing framework

The testing-intelligence workflow analyzes Native Android and Flutter projects, saves custom instructions and test cases, and writes timestamped Markdown/JSON reports under .androidmcp-framework/test-reports/YYYY-MM-DD/HHmmss/. It does not yet claim fully autonomous end-to-end test generation/execution; see Testing Framework.

License

MIT

Frequently asked questions

What is AndroidMCP Framework?

MCP server and CLI for Android development and change-aware Android and Flutter testing workflows.

How do I install AndroidMCP Framework?

It runs on your machine. In Claude Code: claude mcp add androidmcp-framework -- npx -y androidmcp-framework@0.1.12 mcp. For other clients, paste the JSON configuration from this page into their MCP settings.

Does AndroidMCP Framework need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is AndroidMCP Framework open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains AndroidMCP Framework?

It is published by kshivam1177. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.