CodeDroid MCP
The CodeDroid MCP lets your coding agent use your Android phone. With a single prompt, it can fix a crash and retest it on a real device, work through your inbox and CRM, or plan a trip across your apps.
You need Node.js 20+ on your computer and an Android phone.
- 1
Install and connect
Turn on USB debugging, plug your phone into your computer, and run:
Install the
@codedroid/mcp
CodeDroid MCPnpx -y @codedroid/mcp setupIt adds CodeDroid to your coding agents, then installs the app on your phone and connects it. It asks before installing, and needs adb on your computer.
On your phone
- Allow USB debugging
- Sign in with Google
- Tap Allow to connect
- 2
Restart your agents
Once it says Connected, restart your coding agents so they load CodeDroid.
- 3
Ask your agent
Start with “Read the screen on my phone and describe what is open.” Then copy one of these:
Write my daily brief from my unread Gmail from the last 24 hours, today’s Calendar, and my unread WhatsApp and Slack chats, and save it to brief.md. Leave my emails unread.
Splits work from personal and lists who needs a reply.
Fix the signup crash. Keep testing on my phone until it works.
Reproduces it, reads the logs, fixes the code, and retests until signup passes.
Add every new inquiry from Gmail, WhatsApp Business and Instagram to HubSpot. Skip duplicates and draft a reply to each.
Checks each person against your CRM and leaves every reply unsent.
Other ways to connect
No cable?
Run the same command to add CodeDroid to your agents. Get the app, sign in, and turn on its accessibility service when it asks.
In CodeDroid, open Settings → Computers → Pair a computer. Run the command it shows in your terminal, then tap Allow on your phone.
It looks like npx -y @codedroid/mcp pair ABCD-EFGH. Codes expire after 10 minutes and work once.
Already added CodeDroid?
Ask your agent: “Set up my phone.” It uses codedroid_setup_phone and asks before installing anything.
Have a pairing code?
Run npx -y @codedroid/mcp setup ABCD-EFGH with your code. It adds CodeDroid to your agents and pairs in one step.
What’s next
- Example promptsPrompts and multi-step recipes to copy and adapt, for your Android project, your work and your day.
- Tools and skillsEvery tool your agent can use, what comes back, and the skills that guide it.
- FAQConnection, long tasks, safety and privacy, and troubleshooting.
- Full referenceManual setup, environment variables, adb and the CLI.
Another MCP client, adb or environment variables: see the full reference.
@codedroid/mcp on npm