# Buddy phone tools

> Buddy phone tools is an open-source MCP server for productivity. Local MCP tools that let an AI agent read an Android screen, tap and type. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Android, CLI
- **Website:** https://ghorbelhamdi.github.io/buddy-android/
- **Repository:** https://github.com/ghorbelhamdi/buddy-android/tree/HEAD/mcp-bridge
- **MCP Registry name:** io.github.ghorbelhamdi/buddy-phone-bridge
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

This is a small stdio bridge for Buddy, a free open-source Android app that lets coding agents operate the phone through an accessibility service. Buddy itself serves the tools over a local MCP endpoint on 127.0.0.1:8765; the bridge exists for clients that can only launch a server as a command, and passes every request on to Buddy.

The tools cover reading the screen, tapping, typing, scrolling, opening apps, screenshots, notifications and a background browser. Setup needs the Buddy app installed and its token from Settings, Phone tools in your own sessions, passed as BUDDY_TOKEN. The bridge has no dependencies beyond Node 18 and must run on the phone, for example in Termux, because Buddy only listens locally.

When Buddy cannot be reached, the bridge still lists tools from a bundled copy and each call says why it failed. Buddy asks for approval before anything is sent, posted, bought or deleted, and is independent of Anthropic, OpenAI, Google and xAI.

## Features

- **Phone control tools:** Read the screen, tap, type, scroll and open apps.
- **Stdio bridge:** Lets command-launched MCP clients reach Buddy's local server.
- **No root or adb:** Works through an accessibility service on an ordinary Android app.
- **Approval prompts:** Buddy asks before sending, posting, buying or deleting.
- **Offline tool listing:** Lists tools even when the phone app is unreachable.

## Good for

- Have an agent reply to a message on your phone
- Automate a shopping flow in an Android app
- Show someone how to change a phone setting
- Test an Android app flow from your own agent session

## Install

### Claude Code (Terminal)

```sh
claude mcp add buddy-phone-bridge --env BUDDY_TOKEN='<BUDDY_TOKEN>' -- npx -y buddy-phone-bridge
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "buddy-phone-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "buddy-phone-bridge"
      ],
      "env": {
        "BUDDY_TOKEN": "<BUDDY_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "buddy-phone-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "buddy-phone-bridge"
      ],
      "env": {
        "BUDDY_TOKEN": "<BUDDY_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "buddy-phone-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "buddy-phone-bridge"
      ],
      "env": {
        "BUDDY_TOKEN": "<BUDDY_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "buddy-phone-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "buddy-phone-bridge"
      ],
      "env": {
        "BUDDY_TOKEN": "<BUDDY_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "buddy-phone-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "buddy-phone-bridge"
      ],
      "env": {
        "BUDDY_TOKEN": "<BUDDY_TOKEN>"
      }
    }
  }
}
```

## FAQ

### What do I need besides the bridge?

The Buddy app on an Android phone (Android 11+, 64-bit) and its token.

### Where do I run it?

On the phone itself, such as in Termux, since Buddy listens only on 127.0.0.1.

### Is it free?

Buddy is described as free and open source under Apache 2.0.

### Does it need an API key?

No API key is needed; your agent uses its own plan.

### Is Buddy phone tools free?

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

### How do I add Buddy phone tools to Claude Code?

Run this command in your terminal: claude mcp add buddy-phone-bridge --env BUDDY_TOKEN='<BUDDY_TOKEN>' -- npx -y buddy-phone-bridge

### What are the best alternatives to Buddy phone tools?

The closest alternatives to Buddy phone tools are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/buddy-phone-tools
