Skip to content
CodeDroid
MCP setup

Windsurf

Connect Windsurf 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 Windsurf

    Use any one of these, then restart Windsurf.

    Quick install

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

    npx -y @codedroid/mcp setup --client=windsurf

    Manual setup

    Add this to ~/.codeium/windsurf/mcp_config.json:

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

    Keep what’s already in the file and add the codedroid entry next to it.

  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 Windsurf

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

What’s next