Android MCP Server

Control Android devices via the Android Debug Bridge (ADB).

This repository provides anMCP (Model Context Protocol) server for Android device controlthrough ADB (Android Debug Bridge). It exposes simple tools (functions) that can be called from LLMs or clients (like Claude Desktop) to automate Android device actions such as opening Chrome and performing a search.

The goal is to make it easy for any client supporting MCP (such as Claude Desktop) to control an Android device using natural language and safe, auditable tools.

- open_chrome_and_search:
Opens the default browser on a connected Android device and performs a Google search for a given query.
- screenshot_and_preprocess:
Takes a screenshot and preprocesses it for further use.
- send_sms_via_adb:
Sends an SMS message via ADB to a specified number.
- get_device_model:
Retrieves the model name of the connected Android device.
- get_battery_info:
Returns battery status and information.
- get_device_features:
Lists hardware/software features supported by the device.
- get_storage_info:
Provides information about device storage usage.
- get_network_info:
Returns details about the device's network connectivity.
- take_screenshot:
Captures a screenshot from the device.
- open_settings:
Opens the main settings app on the device.
- toggle_airplane_mode:
Enables or disables airplane mode.
- increase_volume / decrease_volume:
Adjusts the device's media volume up or down.
- press_power_button:
Simulates pressing the power button.
- press_home_button:
Simulates pressing the home button.
- press_back_button:
Simulates pressing the back button.
- open_wifi_settings:
Opens the Wi-Fi settings screen.
- open_bluetooth_settings:
Opens the Bluetooth settings screen.
- open_display_settings:
Opens the display settings screen.
- Easily extensible: add more ADB-powered tools as needed (launch apps, take screenshots, etc.)
- Secure: only exposes specific, whitelisted actions.

- Python 3.10+
- ADBinstalled and added to your system PATH
- An Android device with:

- Developer mode enabled
- USB debugging enabled

git clone https://github.com/IngaleChinmay04/android-mcp-server cd android-mcp-server

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

curl -LsSf https://astral.sh/uv/install.sh | sh

uv venv # On Windows: .venv\Scripts\activate # On Mac/Linux: source .venv/bin/activate uv add "mcp[cli]"

The server will wait for MCP client connections.

To connect your MCP server to Claude Desktop:

1. EnsureClaude Desktopis installed andfully up to date.

{ "mcpServers": { "android_control": { "command": "uv", "args": [ "--directory", "C:\\Users\\<YourUsername>\\Desktop\\android-mcp-server", "run", "android_server.py" ] } } }

- Use the absolute path to your project folder.
- Save the config file.

- Fully close all Claude Desktop windows (including tray icon).
- Reopen Claude Desktop.

- Enable Developer Options and USB Debugging on your phone.
- Connect via USB.
- Approve any "Allow USB Debugging" prompts.

In Claude Desktop, you can now use the tool by typing a natural language prompt such as:

- "Search for 'latest Android news' on my Android device."
- "Use the open_chrome_and_search tool with query: Python tutorials"

Claude will invoke the tool, and your phone's browser will open and perform the search.

To extend functionality, simply add more@mcp.tool()decorated Python functions toandroid_server.py.
For example, you can add tools to take a screenshot, install an app, open a specific app, etc.

- No device found?
Make sure you have runadb devicesand see your device listed.
- MCP server not showing up in Claude?
Double check your config file path and syntax, and restart Claude Desktop.
- Unexpected token / JSON errors?
Ensure there are NO print statements or logging to stdout in your server code; all outputs must go via MCP calls only.
- Still stuck?
Check the Claude logs (button in the Claude Desktop UI) for details.

- Anthropic/Claude
- Model Context Protocol (MCP)
- uv by Astral

Catch App Store rejections before they happen