Skip to content
CodeDroid
MCP setup

Claude Code

Connect Claude Code to your Android phone with the CodeDroid MCP.

You need Node.js 20+ on your computer and an Android phone.

  1. 1

    Add CodeDroid to Claude Code

    Use any one of these, then restart Claude Code.

    Quick install

    Run this in your terminal. It adds CodeDroid to Claude Code, and connects your phone if it’s plugged in.

    npx -y @codedroid/mcp setup --client=claude-code

    Claude Code plugin

    Run this in your terminal:

    claude plugin install codedroid --marketplace codedroid-team/codedroid-mcp

    Or run these inside Claude Code:

    /plugin marketplace add codedroid-team/codedroid-mcp
    /plugin install codedroid@codedroid

    Using Claude Desktop?

    Run this instead, then restart it:

    npx -y @codedroid/mcp setup --client=claude-desktop
  2. 2

    Pair your phone

    If your phone was plugged in with USB debugging on, Quick install already connected it. If not, plug it in and run that command again.

    On your phone

    • Allow USB debugging
    • Sign in with Google
    • Tap Allow to connect
  3. 3

    Ask Claude Code

    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.

    Browse all example prompts

Other ways to connect

No cable?

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 Claude Code: “Set up my phone.” It uses codedroid_setup_phone and asks before installing anything.

What’s next