Mobile Device MCP Server

by saranshbamaniaio.github.saranshbamania/mobile-device-mcpv0.2.9

Control Android devices and iOS simulators: AI visual analysis, Flutter widget tree inspection, element finding, video recording and test script generation.

4Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Stale7mo ago

Install Mobile Device MCP server

claude mcp add mobile-device -e GOOGLE_API_KEY='<google-api-key>' -e MOBILE_MCP_LICENSE_KEY='<mobile-mcp-license-key>' -- npx -y mobile-device-mcp

{
  "mcpServers": {
    "mobile-device": {
      "command": "npx",
      "args": [
        "-y",
        "mobile-device-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "<google-api-key>",
        "MOBILE_MCP_LICENSE_KEY": "<mobile-mcp-license-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "mobile-device": {
      "command": "npx",
      "args": [
        "-y",
        "mobile-device-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "<google-api-key>",
        "MOBILE_MCP_LICENSE_KEY": "<mobile-mcp-license-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "mobile-device": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mobile-device-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "<google-api-key>",
        "MOBILE_MCP_LICENSE_KEY": "<mobile-mcp-license-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "mobile-device": {
      "command": "npx",
      "args": [
        "-y",
        "mobile-device-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "<google-api-key>",
        "MOBILE_MCP_LICENSE_KEY": "<mobile-mcp-license-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GOOGLE_API_KEY	—	yes	Google API key for AI visual analysis tools. Get a free key at aistudio.google.com/apikey
MOBILE_MCP_LICENSE_KEY	—	yes	Pro license key to unlock all 49 tools (format: MDMCP-XXXXX-XXXXX-XXXXX-XXXXX). Get Pro at rzp.io/rzp/r4ijQsJY
MCP_ADB_PATH	—	—	Custom path to ADB binary. Auto-detected from PATH if not set.
MCP_DEFAULT_DEVICE	—	—	Device serial number to use when multiple devices are connected. Auto-detected if only one device is connected.

Freshness

Stale — last maintenance signal 7mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-03-23 · 7mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-03-23 · 7mo ago · official registry · v0.2.9

FAQ

›How do I install the Mobile Device MCP server in Claude Code?

Run: claude mcp add mobile-device -e GOOGLE_API_KEY='<google-api-key>' -e MOBILE_MCP_LICENSE_KEY='<mobile-mcp-license-key>' -- npx -y mobile-device-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Mobile Device require an API key?

Yes. It expects GOOGLE_API_KEY, MOBILE_MCP_LICENSE_KEY, of which 2 are secrets.

›Can I use Mobile Device as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Mobile Device in the official MCP registry?

Yes, as io.github.saranshbamania/mobile-device-mcp.