Skip to content
CodeDroid

Quickstart

  1. 1
    Install and connect

    Install the CodeDroid MCP

    npx -y @codedroid/mcp setup

    Plug in your phone with USB debuggingSettings → About phone → tap Build number seven times. Then Settings → System → Developer options → USB debugging. on. The command asks which agents to set up, then installs the app on your phone and connects it.

    Guides by agent

    @codedroid/mcp
  2. 2

    Finish on your phone

    Allow USB debugging, sign in with Google, and tap Allow. Once it says Connected, restart your coding agents so they load CodeDroid.

  3. 3

    Ask your agent

    • Test the changes on this branch on my phone and fix anything that breaks.

      Builds and installs the app, taps through the screens that changed, and retests after each fix.

    Browse all example prompts

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