Buddy phone tools — Claude Code MCP server: install
Buddy phone tools is an MCP server for Claude Code that connects an agent to an Android phone through Buddy. It runs when the agent needs to inspect the display or control an app.
Apache-2.0 ★ 314 updated 2026-10-29
claude mcp add --env BUDDY_TOKEN=<BUDDY_TOKEN> --env BUDDY_URL=<BUDDY_URL> --transport stdio mcp-bridge -- npx -y buddy-phone-bridgeWhat Buddy phone tools does
Buddy phone tools forwards MCP requests to the Buddy app on an Android phone. The agent can inspect the display, tap controls, enter text, scroll, and launch apps. It can also request screenshots and notifications.
The bridge starts as a command over stdio and needs Node 18+ plus the BUDDY_TOKEN shown in Buddy’s settings. Buddy must be installed on the phone. Since the app listens only on 127.0.0.1, run the bridge on that phone, for example in Termux.
What it helps with
- inspect what is shown on an Android display
- tap an interface control or enter text
- scroll a page and launch an app
- retrieve a phone screenshot or its notifications
Example prompts for the agent
- Read my phone screen and summarize what is open.
- Launch the needed app on my phone.
- Scroll down the page and enter text in the active field.
How to install Buddy phone tools
Platform CLI
claude mcp add --env BUDDY_TOKEN=<BUDDY_TOKEN> --env BUDDY_URL=<BUDDY_URL> --transport stdio mcp-bridge -- npx -y buddy-phone-bridgeReplace <…> with your own values
Platform CLI
codex mcp add mcp-bridge --env BUDDY_TOKEN=<BUDDY_TOKEN> --env BUDDY_URL=<BUDDY_URL> -- npx -y buddy-phone-bridgeReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp-bridge": {
"command": "npx",
"args": [
"-y",
"buddy-phone-bridge"
],
"env": {
"BUDDY_TOKEN": "<BUDDY_TOKEN>",
"BUDDY_URL": "<BUDDY_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"buddy-phone-bridge"
],
"env": {
"BUDDY_TOKEN": "<BUDDY_TOKEN>",
"BUDDY_URL": "<BUDDY_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e BUDDY_TOKEN=<BUDDY_TOKEN> -e BUDDY_URL=<BUDDY_URL> mcp-bridge npx -y buddy-phone-bridgeReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Buddy phone tools
How do I install Buddy phone tools in Claude Code?
Run claude mcp add buddy-phone-bridge -e BUDDY_TOKEN=<BUDDY_TOKEN> -- npx -y buddy-phone-bridge. Replace the placeholder with the token from Buddy settings.
What does Buddy phone tools do?
It connects an MCP client to the Buddy app on an Android phone. The agent can inspect the display, interact with controls, enter text, and launch apps.
What does Buddy phone tools need to run?
It needs the Buddy Android app, Node 18+, and the BUDDY_TOKEN from Buddy settings. Buddy listens only on 127.0.0.1, so the bridge must run on the phone.