# CodeDroid MCP server

> Allows AI clients to control Android phones by reading the screen, tapping, typing, and running ADB commands for app testing and automation.

- Repository: https://github.com/codedroid-team/codedroid-mcp
- Page: https://hostedmcp.org/servers/codedroid-team/codedroid-mcp
- Transport: stdio
- Stars: 2
- License: MIT
- Latest version: 0.1.15

## Install

### Claude Code

```sh
claude mcp add codedroid-mcp -- npx -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"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.codedroid-mcp]
command = "npx"
args = ["-y", "@codedroid/mcp"]
```

### Gemini CLI (`~/.gemini/settings.json`)

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

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CODEDROID_MCP_ADB` | no | no | Set to 0 to turn off the adb tool, which runs adb commands on this computer. |
| `CODEDROID_MCP_CLIENT` | no | no | Client name shown on the phone while the agent uses it. |
| `CODEDROID_SERIAL` | no | no | adb serial of the phone to use when several devices are connected. |

## FAQ

### What kind of interactions can the AI perform on my phone?

The AI can read the screen, take screenshots, tap, type, swipe, open apps, and execute multi-step tasks.