Server data from the Official MCP Registry
Use your real Android phone from any MCP client: read the screen, tap, type, run tasks and adb.
About
Use your real Android phone from any MCP client: read the screen, tap, type, run tasks and adb.
Security Report
Valid MCP server (1 strong, 1 medium validity signals). 5 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.
4 files analyzed · 6 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: CODEDROID_MCP_ADB
Environment variable: CODEDROID_SERIAL
Environment variable: CODEDROID_MCP_CLIENT
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@codedroid/mcp@0.1.15"
],
"env": {
"CODEDROID_SERIAL": "your-codedroid-serial-here",
"CODEDROID_MCP_ADB": "your-codedroid-mcp-adb-here",
"CODEDROID_MCP_CLIENT": "your-codedroid-mcp-client-here"
}
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub README.
CodeDroid MCP
Let Claude Code, Codex, Antigravity, or any MCP client use your Android phone. Read the screen, interact with apps, take screenshots, and test what you build through CodeDroid. Your phone and computer can be on different networks.
Get started
You'll need Node.js 20+ and an Android phone. Both devices need internet access.
Fastest: plug in your phone
Turn on USB debugging on the phone, plug it into your computer, and run:
npx -y @codedroid/mcp setup
It adds CodeDroid to every coding client it finds (Claude Code, Codex, Antigravity, Cursor, VS Code, Claude Desktop, Windsurf, Zed), installs the CodeDroid app on the phone, turns on its accessibility service, and pairs the phone with this computer. On the phone, you allow USB debugging for this computer, sign in to CodeDroid with Google, and tap Allow when your computer first connects. Then restart your coding client.
Already have the plugin? Ask your agent to "set up my phone" instead: it does the same, and asks you before installing anything. Setting up over USB needs adb.
Or step by step
1. Install for your coding client
Every client at once: run npx -y @codedroid/mcp setup in your terminal. Or for one client:
Claude.ai, Claude Desktop, Cowork, or Claude Code without installing anything: add
CodeDroid from Claude's directory (the CodeDroid plugin, or the connector), then sign in
with the Google account you use in the CodeDroid app. Nothing runs on your computer: Claude
reaches your phone through CodeDroid's server, so there is no pairing, but no adb or
install_apk either. In Claude Code you can also add it by URL:
claude mcp add --transport http codedroid https://orchestrator.codedroid.com/mcp
Claude Code, with adb and installs from this computer: run in your terminal:
claude plugin install codedroid --marketplace codedroid-team/codedroid-mcp
Codex: run in your terminal:
codex plugin marketplace add codedroid-team/codedroid-mcp
codex plugin add codedroid@codedroid
Antigravity: run in your terminal:
npx -y @codedroid/mcp setup --client=antigravity
It adds the CodeDroid plugin to ~/.gemini/config/plugins. Restart Antigravity and find it under
Customizations > Installed.
Cursor: Add to Cursor
VS Code: Install in VS Code
Zed: add this to ~/.config/zed/settings.json (Windows: %APPDATA%\Zed\settings.json):
{
"context_servers": {
"codedroid": {
"command": "npx",
"args": ["-y", "@codedroid/mcp"]
}
}
}
Each plugin includes the MCP server and skills for phone control and Android app testing. Restart your coding client after installing.
Using another client? See manual MCP setup.
2. Pair your phone
-
Install CodeDroid from get.codedroid.com, sign in, and turn on its accessibility service when it asks.
-
Open CodeDroid → Settings → Computers → Pair a computer.
-
Run the command shown there in your computer's terminal. For example:
npx -y @codedroid/mcp pair ABCD-EFGH -
Tap Allow on your phone when prompted.
Use the command exactly as shown. Pairing codes expire after 10 minutes and work once.
Ask your agent
Read the screen on my phone and describe what is open.
Then try:
- “Open Android Settings and check the Android version.”
- “Open my app, navigate to sign-in, and take a screenshot.”
- “Install this APK, launch it, and check for crashes.”*
*install_apk works over CodeDroid's connection, with one setting to allow. Reading logs with adb also requires
Android platform-tools and a USB or wireless debugging connection. See adb setup.
What it includes
- MCP tools to read the screen, take screenshots, tap, type, swipe, open apps, and hand CodeDroid's agent a multi-step task, on one phone or several. See the tool list.
- Skills:
codedroid-phoneteaches the agent to drive the phone one checked step at a time, andtest-on-devicewalks it through building, installing, and verifying an Android app change.app-e2etests an app end to end: it explores the app, writes a test PRD, critical user journeys and test cases into its repo (e2e/), stops for your review of each, runs the cases on the phone and writes a report with a screenshot per case. Each step is its own skill (app-e2e-explore,-prd,-cujs,-testcases,-run). Thenapp-e2e-rerunruns some of the cases (by id, journey or priority, last failures, the ones a change touches, a flaky check),app-e2e-bugturns a bug into a case that reproduces it, andapp-e2e-maintainkeeps the cases current as the app changes. install_apkto install a build from your computer, with no cable or shared network.- An
adbtool that runs adb commands on your computer, to read logs and run tests. You can turn it off.
The last two run on your computer, so they come with the local install only. The directory's
plugin has the phone tools and the skills; the connector, and adding the server by URL, have the
phone tools alone. claude-plugin/ in this repository is what the directory lists.
Privacy and security
The plugin runs npx -y @codedroid/mcp@<version>, which downloads this exact release from npm
and starts a local MCP server. Everything it sends goes over TLS to the CodeDroid server, orchestrator.codedroid.com
unless the pairing command shown on your phone names another:
- Pairing sends the one-time code, your computer's name, and its OS (for example
darwin), so the phone can show which computer is connected. - Setting up over USB downloads the app from
get.codedroid.com, checks it against the published SHA-256 before installing it, and changes only CodeDroid's own settings on the phone (its accessibility service, keyboard and permissions). It installs only after you agree. - Tool calls are relayed between your agent and the phone: screen contents, screenshots, text you ask it to type, clipboard reads and writes, and task progress. Each call also names the MCP client that made it and its version. The phone asks you to Allow a computer the first time, shows when one is in use, and can stop or revoke it.
The local server listens on 127.0.0.1 only and requires a per-user token. Pairing credentials,
the token, and logs stay in ~/.codedroid on your computer. The adb tool runs only on your
computer, and its push and pull stay within your project and temp directories. See
Architecture for details.
The plugin itself collects no analytics. The CodeDroid app and server keep usage records under
your CodeDroid account: pairing and connecting, whether a computer was allowed, and for each phone
tool call its name, whether it worked and its error code, how long it took, the MCP client,
session and versions involved, your computer's OS and a random id for it, and the task id of a
run_task. Usage records never include tool arguments, screen contents, or text you type.
When your agent calls run_task, the instruction travels through the CodeDroid relay to your phone,
which runs the task with CodeDroid's servers and our AI model provider (OpenAI). The relay passes
messages through without storing them. CodeDroid does not keep task content (instructions, task
history, screen contents, screenshots, text the agent types, clipboard contents, or model inputs and
outputs) beyond what is needed to run the task, and never longer than 30 days. While your account is
open we keep only task metadata: ids, timestamps, status, token counts, cost, tool names, error
codes, and a one-way hash of the instruction. OpenAI may keep task conversations for a limited time
under its own data policies. CodeDroid is not intended for users under 18. See the
privacy policy.
Need help?
Check your connection:
npx -y @codedroid/mcp status
Manage or revoke computer access in CodeDroid → Settings → Computers.
See the reference guide for tools, manual setup, configuration, troubleshooting, and development.
License
MIT © 2026 CodeDroid
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
