bob-control-mcp
v1.2.7
Published
MCP plugin for remote Android phone control — ADB (local) or cloud relay
Downloads
285
Maintainers
Readme
bob-control-mcp
MCP plugin for remote Android phone control — ADB (local) or cloud relay.
Screenshot, tap, swipe, type, read UI tree, manage apps and notifications — all from Claude Code.
Install
npm install -g bob-control-mcp
claude mcp add -s user bob-control -- bob-control-mcpRestart Claude Code after adding.
Setup
ADB mode (local, fast, no internet)
- Install BOB Control on your Android phone
- Connect phone via USB, enable USB debugging
- In BOB Control app: Step 6 → Start ADB Server
- Plugin auto-detects the device on startup
Cloud mode (remote, no USB needed)
- Install BOB Control app, complete device pairing (Step 1)
- In Claude Code, ask Claude to connect to your phone
- Claude calls
phone_authenticate→ browser opens → log in on bob.tools - Tokens are saved automatically, auto-refresh enabled
Switching modes
Plugin auto-detects: ADB if a device is connected via USB, otherwise cloud. To switch manually, ask Claude to use phone_set_transport.
Tools
| Tool | Description |
|------|-------------|
| phone_authenticate | Log in for cloud mode (OAuth) |
| phone_logout | Clear stored cloud tokens |
| phone_set_transport | Switch between "adb" and "cloud" |
| phone_status | Show connection status |
| phone_screenshot | Take a screenshot (JPEG) |
| phone_get_ui_tree | Get accessibility tree (preferred for reading text) |
| phone_get_settings | Read device control settings |
| phone_tap | Tap at coordinates |
| phone_tap_text | Tap element by visible text |
| phone_swipe | Swipe gesture |
| phone_type | Type text into focused field |
| phone_press_back | Press Back |
| phone_press_home | Press Home |
| phone_press_recents | Press Recent Apps |
| phone_get_apps | List installed apps |
| phone_open_app | Open app by package name |
| phone_get_notifications | Get active notifications |
| phone_open_notification | Open notification by key |
| phone_dismiss_notification | Dismiss notification |
| phone_dismiss_all_notifications | Dismiss all |
| phone_list_devices | List devices (cloud) |
| phone_select_device | Select device (cloud) |
License
MIT
