# NexusAndroid

> NexusAndroid is an open-source MCP server for productivity. ADB-based Android control for AI agents with 18 tools, no root and no phone app. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Android, Windows, CLI
- **Website:** https://julienpiron.fr/nexusandroid/
- **Repository:** https://github.com/pironjulien/nexusandroid
- **MCP Registry name:** io.github.pironjulien/nexus-android
- **Categories:** productivity, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/nexusandroid
