Skip to content
MCP server

NexusAndroid

ADB-based Android control for AI agents with 18 tools, no root and no phone app

Runs locallyStatus and history
Pricing
Open source
Platforms
Android, Windows, CLI
Runs
Locally
Version
0.25.5
Listing updated
3 days ago

About NexusAndroid

NexusAndroid is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Everything goes through plain ADB over a USB cable or local Wi-Fi, so nothing is installed on the phone and no cloud relay is involved. The installer fetches Google's Platform Tools if adb is missing, and environment variables can pin the adb path, a device serial, the keep-awake behaviour and the download step.

Agents work in a see-then-act loop: look returns a numbered UI tree with text first, and act sends batched gestures, each checked against a fresh reading. Beyond taps and typing, the tools read SMS and RCS from Android's own providers, prepare replies that send only after your approval, exchange files under /sdcard without overwriting or deleting, and run a health check on the system, security patch, battery and storage.

Safeguards include masked security codes, protected banking apps, one agent at a time and refusal of deletions without confirm=true. The README reports a conversation-list read in 0.07 seconds after version 0.5.0.

Install

Run in a terminal

claude mcp add nexus-android -- npx -y https://github.com/pironjulien/NexusAndroid/releases/download/v0.25.5/nexus-android.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "nexus-android": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusAndroid/releases/download/v0.25.5/nexus-android.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "nexus-android": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusAndroid/releases/download/v0.25.5/nexus-android.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "nexus-android": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusAndroid/releases/download/v0.25.5/nexus-android.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "nexus-android": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusAndroid/releases/download/v0.25.5/nexus-android.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "nexus-android": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusAndroid/releases/download/v0.25.5/nexus-android.mcpb"
      ]
    }
  }
}

Configuration

  • NEXUS_ANDROID_ADBFull path to adb when it is not on the PATH
  • NEXUS_ANDROID_SERIALForce a device by serial number or ip:port
  • NEXUS_ANDROID_KEEP_AWAKE0 turns off the keep-screen-on session while the agent works
  • NEXUS_ANDROID_ADB_DOWNLOAD0 never downloads Google's Platform Tools when adb is missing (nor the pinned scrcpy server)

Tools this server provides (18)

Taken from the project documentation; the running server may differ.

phone
Link state, model, screen, fold state and restart.
look
Screen image and numbered elements, with text read from the image if needed.
act
Batched gestures: tap, type, scroll, zoom, drag and links.
launch
Opens an app or a specific screen.
map
Map of settings with current values and direct access.
functions
Direct app actions: alarms, reminders, notes, calendar, contacts.
web
Reads web pages open on the phone.
apps
Info, stop, clear, install and uninstall an app.
messages
Reads SMS and RCS with attachments.
draft
Prepares a reply sent only after your approval.
notifications
Reads shown notifications.
clipboard
Reads or sets the clipboard with codes masked.
files
Exchanges /sdcard files with the PC without overwriting.
capture
Saves screenshots or video to the PC.
logs
Android logs for diagnosing crashes.
info
Read-only location, calls, contacts and calendar.
settings
Changes Wi-Fi, Bluetooth, data and other settings.
checkup
Health check of system, patch, battery and storage.

What it does

Plain ADB
USB or local Wi-Fi, no root and no app on the phone.
Numbered UI tree
look lists screen elements so gestures can target them.
Messages without the screen
Reads SMS and RCS and drafts replies that need your approval.
Settings and checkup
Toggles Wi-Fi, Bluetooth and more, and reports phone health.
Masked secrets
Hides security codes in messages, clipboard and captures.
Shared by three agents
Claude Code, Codex and Antigravity use one lock and one server.

Good for

  • Let an agent operate a real phone to reproduce an app bug
  • Read and answer SMS without touching the screen
  • Set alarms, reminders or calendar entries through app functions
  • Pull logs to see why an app crashes

Pricing

Open source

Open source; prices not published

Prices change. Check julienpiron.fr before you buy.

NexusAndroid FAQ

Does it need root?

No, and no app on the phone.

How is the phone connected?

By USB cable or local Wi-Fi through ADB.

How many tools are there?

Eighteen, including phone, look, act, messages, files, capture and checkup.

What are deletions guarded by?

Destructive taps are refused without confirm=true.

Is NexusAndroid free?

Yes. NexusAndroid is open source, so you can use and self-host it for free.

How do I add NexusAndroid to Claude Code?

Run this command in your terminal: claude mcp add nexus-android -- npx -y https://github.com/pironjulien/NexusAndroid/releases/download/v0.25.5/nexus-android.mcpb

What are the best alternatives to NexusAndroid?

The closest alternatives to NexusAndroid are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to NexusAndroid

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity