Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env BUDDY_TOKEN=<BUDDY_TOKEN> --env BUDDY_URL=<BUDDY_URL> --transport stdio mcp-bridge -- npx -y buddy-phone-bridge
Open on GitHub

What 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-bridge

Replace <…> 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.

Similar MCP servers

All MCP servers for Mobile →

Project sponsors

Companies that keep this analytics open