Skip to content
MCP server

CodeDroid

Lets coding agents read, tap and type on a real Android phone

Runs locallyStatus and history
Install
Platforms
Android, CLI
Runs
Locally
Version
0.1.15
Listing updated
today

Similar MCP servers

About CodeDroid

CodeDroid is an MCP server for developer tools. It runs locally on your machine and is started by your AI client.

CodeDroid gives an agent a physical phone to work with. Through the Android app and its accessibility service, a coding client can read what is on screen, interact with apps, take screenshots and test what it just built, even when the phone and computer are on different networks.

Setup is one command, npx -y @codedroid/mcp setup, with USB debugging enabled. It adds the server to the coding clients it finds, installs the app on the phone and pairs the two; you sign in with Google and tap Allow on first connection. A hosted option reaches the phone through CodeDroid's server instead, which needs no pairing but gives up adb and APK installs.

Three environment variables tune the local package: one turns the adb tool off, one picks a phone by serial when several are attached, and one sets the client name shown on the phone while the agent is using it.

Install

Run in a terminal

claude mcp add codedroid-mcp -- npx -y @codedroid/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "codedroid-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@codedroid/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "codedroid-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@codedroid/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "codedroid-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@codedroid/mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "codedroid-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@codedroid/mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "codedroid-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@codedroid/mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • CODEDROID_MCP_ADBSet to 0 to turn off the adb tool, which runs adb commands on this computer.
  • CODEDROID_SERIALadb serial of the phone to use when several devices are connected.
  • CODEDROID_MCP_CLIENTClient name shown on the phone while the agent uses it.

What it does

Screen reading
Agents can read what the phone is showing.
Tap and type control
Interacts with apps on a real device rather than an emulator.
One-command setup
npx @codedroid/mcp setup configures clients and installs the app over USB.
Hosted option
A remote endpoint works without pairing but without adb or install_apk.
adb switch
CODEDROID_MCP_ADB=0 disables the tool that runs adb on your computer.
Multi-client support
Works with Claude Code, Codex, Cursor, VS Code, Claude Desktop, Windsurf, Zed and Antigravity.

Good for

  • Test an Android app you just built on a real phone
  • Have an agent walk through a flow and capture screenshots
  • Automate an everyday task on the phone from a coding client
  • Install and launch a build over adb

Pricing

Pricing unknown

Prices not published

Prices change. Check get.codedroid.com before you buy.

CodeDroid FAQ

What do I need locally?

Node.js 20 or later and an Android phone with internet access; USB setup also needs adb.

Can I use it without installing anything?

Claude's directory connector or the hosted URL reaches the phone through CodeDroid's server, without adb or install_apk.

How do I pick a phone when several are connected?

Set CODEDROID_SERIAL to the adb serial.

Can I turn off adb access?

Yes, set CODEDROID_MCP_ADB to 0.

How do I add CodeDroid to Claude Code?

Run this command in your terminal: claude mcp add codedroid-mcp -- npx -y @codedroid/mcp

What are the best alternatives to CodeDroid?

The closest alternatives to CodeDroid are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers