# Buddy phone tools (MCP server)

> Buddy phone tools is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Android phone tools for AI agents (read the screen, tap, type, open apps), served by the Buddy app. It has 260 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y buddy-phone-bridge.

This needs the free Buddy app on your Android phone: download the APK or see Buddy on GitHub. Buddy lets AI agents read your screen, tap and type, and asks before anything risky. No root, no adb, no PC.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/ghorbelhamdi/buddy-android |
| GitHub stars | 260 |
| License | Apache-2.0 |
| Language | Java |
| Transport | stdio |
| Packages | npm: buddy-phone-bridge |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Developer tools |
| Latest release | v2.3.10 (Nov 15, 2026) |
| Last commit | Nov 15, 2026 |
| MCP registry name | io.github.ghorbelhamdi/buddy-phone-bridge |

## Install

### Claude Desktop (claude_desktop_config.json)

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

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env BUDDY_TOKEN=your-value --transport stdio buddy-phone-tools -- npx -y buddy-phone-bridge
```

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

```json
{
  "mcpServers": {
    "buddy-phone-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "buddy-phone-bridge"
      ],
      "env": {
        "BUDDY_TOKEN": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

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

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "buddy_token",
      "description": "BUDDY_TOKEN",
      "password": true
    }
  ],
  "servers": {
    "buddy-phone-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "buddy-phone-bridge"
      ],
      "env": {
        "BUDDY_TOKEN": "${input:buddy_token}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `BUDDY_TOKEN` (secret) (required): Token from Buddy's Settings > Phone tools in your own sessions
- `BUDDY_URL`: Buddy's address, if not http://127.0.0.1:8765/mcp

## Similar MCP servers

- [QVeris](https://appsgit.com/mcp-servers/qveris): Professional data and tools for AI: find services, review scope, call them, and audit usage. (264 stars, MIT, needs API key)
- [olcli](https://appsgit.com/mcp-servers/olcli): Overleaf projects from an MCP client: files, compile and PDF, diff, comments and tracked changes. (258 stars, MIT, needs API key)
- [Figma UI MCP](https://appsgit.com/mcp-servers/figma-ui-mcp): Bidirectional Figma MCP — AI draws UI on Figma canvas, reads designs back. (266 stars, MIT)
- [Mobai MCP](https://appsgit.com/mcp-servers/mobai-mcp): AI-powered mobile device automation for Android and iOS devices, emulators, and simulators. (255 stars, Apache-2.0)
- [Kinocut](https://appsgit.com/mcp-servers/kinocut): Guardrailed video editing for AI agents: FFmpeg, captions, effects, Hyperframes, and receipts. (267 stars, Apache-2.0, official)
- [Git MCP Server](https://appsgit.com/mcp-servers/git-mcp-server): Comprehensive Git MCP server enabling native git tools including clone, commit, worktree, & more. (245 stars, Apache-2.0)

---

Canonical page: https://appsgit.com/mcp-servers/buddy-phone-tools
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.
