# CodeDroid

> CodeDroid is an MCP server for developer tools. Lets coding agents read, tap and type on a real Android phone. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** Android, CLI
- **Website:** https://get.codedroid.com
- **Repository:** https://github.com/codedroid-team/codedroid-mcp
- **MCP Registry name:** io.github.codedroid-team/codedroid-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/codedroid
