# CodeDroid (npm · @codedroid/mcp)

Use your real Android phone from any MCP client: read the screen, tap, type, run tasks and adb.

- Trust score: 71/100 (medium)
- Change this week: +16
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- npm · `@codedroid/mcp`: 71/100 (this document), [markdown](https://verifymcp.io/servers/codedroid-team-codedroid-mcp/codedroid-mcp.md), [page](https://verifymcp.io/servers/codedroid-team-codedroid-mcp/codedroid-mcp)

## Channel facts

- Registry: `npm`
- Package: `@codedroid/mcp`
- Version: `0.1.4`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 30 of 93 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 1 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 61/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1248 tokens (~312/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 4 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 5 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the CodeDroid MCP server?

CodeDroid runs locally as an npm package, launched with npx -y @codedroid/mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add codedroid-team-codedroid-mcp -- npx -y @codedroid/mcp
```

### Cursor

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

### VS Code

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

### Codex

```bash
codex mcp add codedroid-team-codedroid-mcp -- npx -y @codedroid/mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "codedroid-team-codedroid-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@codedroid/mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add codedroid-team-codedroid-mcp --command npx --arg -y --arg @codedroid/mcp
```

### Hermes

```yaml
mcp_servers:
  codedroid-team-codedroid-mcp:
    command: "npx"
    args: ["-y", "@codedroid/mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "codedroid-team-codedroid-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@codedroid/mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add codedroid-team-codedroid-mcp -t stdio -c npx -a -y @codedroid/mcp
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 71, +16)

- [security improvement] Malware scan: unverified → pass

### 2026-11-04 (score 55, −15)

- [security regression] Malware scan: pass → unverified
- [functional regression] Schema quality: pass → fail
- [functional improvement] Stability: unverified → 0.20
- [functional] Schema quality: good → excellent
- [functional] Package version: 0.1.3 → 0.1.4

### 2026-10-30 (score 70, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-29 (score 55)

First indexed and scored.

## MCP tools (4)

### `codedroid_devices` (~72 tokens)

Paired phones

List the Android phones paired with this computer: each one's id and model (what phone tools take as device), its CodeDroid server, and its link now: connected, connecting or disconnected, with the last problem. Instant; it does not connect. codedroid_status connects and says how to fix a problem.

### `codedroid_status` (~111 tokens)

CodeDroid connection

Which Android phones are paired with this computer (each one's device id, model and CodeDroid server), whether CodeDroid on each is connected, and if not, why and how to fix it. Also retries the connection. Once connected it returns the phones' instructions for driving them. Pass device for one phone alone.

Input parameters:

- `device` (string): Which paired phone runs this: its id, or its model or part of it, as codedroid_devices lists them. Required when several phones are paired.

### `install_apk` (~264 tokens)

Install an APK

Install an APK from this computer on the phone, through CodeDroid's own connection: no USB cable, shared network or adb. Use it after each build, then check the result with open_app and get_screen.

Pass the path to one .apk: relative to the working directory, or absolute. An App Bundle or split APKs will not install. Returns the package and version that were installed.

\- If it says it is still working, call it again with the same path to keep waiting.
\- Android's refusals come back as they are, with what to do. Removing an installed app deletes its data: ask the user first.
\- It confirms Android's own install prompt. The first time, CodeDroid has to be allowed to install apps: the error says how.
\- It takes Play Protect's Install without scanning when it offers a scan. A warning about a harmful app is left for the user: the error says so.

Input parameters:

- `device` (string): Which paired phone runs this: its id, or its model or part of it, as codedroid_devices lists them. Required when several phones are paired.
- `path` (string, required): The .apk on this computer, e.g. app/build/outputs/apk/debug/app-debug.apk

### `adb` (~623 tokens)

Run adb

Run an adb command against the phone attached to this computer. Pass what you would type after `adb`, e.g. `install -r -g app/build/outputs/apk/debug/app-debug.apk`, `logcat -d -t 300 *:E`, `shell dumpsys activity activities`. Runs this machine's adb, so the phone must be on it (USB or Wireless debugging): CODEDROID_SERIAL or ANDROID_SERIAL, or -s in the command, picks it when several devices are; otherwise adb's own default. Relative paths start from the client's working directory; use absolute ones if adb says it has none.

USEFUL:
\- Install and start: `install -r -g <apk>`, `shell am start -W -n <pkg>/<activity>`, `shell am force-stop <pkg>`, `shell pm clear <pkg>`.
\- Logs: clear with `logcat -c` before acting, then `logcat -d -t 300`; crashes only: `logcat -d -b crash`; one app: `shell pidof <pkg>` then `logcat -d --pid=<pid>`.
\- Tests: `shell am instrument -w -r <test-pkg>/androidx.test.runner.AndroidJUnitRunner` (add `-e class <Class>`; set timeout_s); read the INSTRUMENTATION_STATUS lines.
\- State: `shell dumpsys window | grep mCurrentFocus`, `shell dumpsys package <pkg>`, `shell settings get global <key>`.

RULES:
\- On a phone with several users, `settings`, `content`, `pm grant` and `appops` need `--user $(adb shell am get-current-user)`; adb defaults to user 0.
\- Do not force-stop, clear or instrument com.codedroid.app: it switches CodeDroid's accessibility off and its tools stop working.
\- `uiautomator dump` and UiAutomator-based tests suspend CodeDroid's accessibility while they run; use get_screen to read the screen.
\- Never stream: `logcat` without `-d`, `screenrecord` without `--time-limit` run until timeout_s.
\- Ask the user before uninstalling, clearing data, rebooting or deleting files.
\- `push`, `pull`, `bugreport`, `backup` and `restore` only use local files in the project or the temp directory; `install` takes any path.
\- Quotes group words for adb itself (`install "my app.apk"`); everything after `shell` goes to the phone's shell as written, w…

Input parameters:

- `command` (string, required): Arguments to pass to adb, e.g. 'shell pm list packages -3'
- `timeout_s` (number): Seconds before it is stopped (default 60, 300 for installs and file transfers, max 900)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/codedroid-team-codedroid-mcp/codedroid-mcp#diagnostics

## Score history

- 2026-11-05: 71
- 2026-11-04: 55
- 2026-11-03: 70
- 2026-11-02: 70
- 2026-11-01: 70
- 2026-10-31: 70
- 2026-10-30: 70
- 2026-10-29: 55

## Common questions

### What is the CodeDroid MCP server?

CodeDroid is an MCP server listed in the public MCP registry as io.github.codedroid-team/codedroid-mcp. Use your real Android phone from any MCP client: read the screen, tap, type, run tasks and adb. This page covers its npm package (@codedroid/mcp).

### Is the CodeDroid MCP server safe to use?

CodeDroid scores 71 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the CodeDroid MCP server expose?

CodeDroid exposes 4 tools: codedroid_devices, codedroid_status, install_apk, adb. Their descriptions and schemas cost roughly 1,070 tokens of context every time the server is loaded.

### Is the CodeDroid MCP server still maintained?

CodeDroid is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the CodeDroid MCP server under?

CodeDroid declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/@codedroid/mcp
- Socket report: https://socket.dev/npm/package/@codedroid/mcp
- Repository: https://github.com/codedroid-team/codedroid-mcp
- Website: https://get.codedroid.com/
- Changelog RSS feed: https://verifymcp.io/servers/codedroid-team-codedroid-mcp/codedroid-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/codedroid-team-codedroid-mcp/codedroid-mcp.json
- HTML version of this page: https://verifymcp.io/servers/codedroid-team-codedroid-mcp/codedroid-mcp