Which integrations are available for this server?

Allows AI-powered control of an Android device, including screen interaction, app management, file operations, and system settings via ADB and Shizuku. Provides AI vision capabilities for screen element recognition using OpenAI's GPT-4o API.

How do I use Android MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Android MCP Server open the Settings app" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Android MCP Server

by shuao-pro

Overview Schema Related Servers Score Discussions

Python

Hybrid

Android MCP Server

AI-powered Android device automation via MCP (Model Context Protocol).

Control an Android phone with natural language — through Claude Desktop, Cherry Studio, Kai 9000, or the built-in Web GUI with AI chat.

🏗️ Architecture

flowchart LR
    A["🤖 MCP Client<br/>Claude / Kai 9000 / Cherry"]
    B["🐍 Python Server<br/>FastMCP + Web GUI :8080"]
    C["📱 Android Device<br/>Shizuku App :18080"]

    A <-->|"SSE / stdio / HTTP<br/>:9000"| B
    B <-->|"JSON-RPC<br/>ADB tunnel"| C

    B -.->|"Vision API"| D["🧠 AI Vision<br/>Claude / GPT-4o"]
    C -.->|"UID 2000"| E["⚡ System APIs<br/>Shell / Input / Files"]

Layer	Role	Key Tech
🤖 MCP Client	AI assistant connects via MCP	Claude Desktop, Kai 9000, Cherry Studio
🐍 Python Server	Tool registry, Web GUI, AI chat agent	FastMCP + FastAPI + WebSocket
📱 Android App	System-level execution on device	Shizuku (UID 2000), HTTP JSON-RPC

💡 The server can run on the phone itself (Termux / Kai 9000). Set ANDROID_HOST=127.0.0.1 — no ADB needed.

Related MCP server: scrcpy-mcp

✨ Features

Device Control (29 MCP Tools)

Category	Tools
Device	`health_check`, `get_device_info`, `get_battery_info`
Shell	`shell` — any ADB-level command
Input	`click`, `long_click`, `swipe`, `drag`, `type_text`, `press_key`
Apps	`open_app`, `close_app`, `clear_app_data`, `install_app`, `uninstall_app`, `get_current_app`, `list_installed_apps`
Screen	`take_screenshot`, `get_ui_hierarchy`
Files	`read_file`, `write_file` (including `/data/data`)
System	`get_system_setting`, `put_system_setting`, `set_clipboard`, `get_clipboard`, `get_notifications`, `start_activity`
Vision	`find_element` — AI locates UI elements, `click_element` — find + click in one step

AI Vision

AI-powered screen element recognition via Claude Vision / GPT-4o / custom API
Natural language → pixel coordinates → automated click
Example: find_element("the login button") → {center_x: 540, center_y: 960, confidence: 0.95}

Web Dashboard

AI Chat — control the phone by typing "open settings" or "click the search icon"
Live Screen — 10fps WebSocket stream with click-to-touch
scrcpy — native low-latency mirroring (one-click launch)
Setup Wizard — guided 5-step setup with auto-detection + MCP SSE endpoint display
Settings Panel — configure API providers + ADB device manager with .env sync
中/English — full i18n support
Shell Terminal — live ADB shell in the browser

MCP Clients

Connect any MCP-compatible client to the server:

Client	Transport	Endpoint	Platform
Kai 9000	Streamable HTTP	`:9000/mcp`	Android (F-Droid)
Cherry Studio	Streamable HTTP	`:9000/mcp`	Windows / macOS / Linux
Claude Desktop	SSE / stdio	`:9000/sse` or `stdio`	Windows / macOS / Linux
Termux + curl	SSE	`:9000/sse`	Android (Termux)

Cherry Studio config: Set MCP type to streamableHttp, URL http://<lan_ip>:9000/mcp. Or import cherry-studio-mcp.json from the project root.

MCP Transport

Mode	Endpoint	Use Case
`stdio`	(local pipe)	Claude Desktop local integration
SSE	`:9000/sse`	Claude Desktop remote, web frontends
Streamable HTTP	`:9000/mcp`	Kai 9000, modern MCP clients
Combined (default)	both on `:9000`	SSE + Streamable HTTP simultaneously

🔗 Links

Resource	URL
GitHub	github.com/shuao-pro/android-mcp
Issues	Report a bug / Request feature
README 中文	README_zh.md

🚀 Quick Start

Prerequisites

Python 3.10+
Android device with Shizuku installed
ADB (Android SDK Platform Tools)
scrcpy (optional, for native mirroring)

1. Install

git clone https://github.com/shuao-pro/android-mcp.git
cd android-mcp
pip install -e .

2. Setup

# First-time setup (configures .env)
bash scripts/setup.sh

Or manually:

cp .env.example .env

Install the Android APK to your phone:

# Pre-built APK (recommended) 鈥?from the android/ project
adb install "android/app/build/outputs/apk/debug/app-debug.apk"

# Or build from source
cd android && .\gradlew assembleDebug
adb install app/build/outputs/apk/debug/app-debug.apk

3. On Your Phone

Start Shizuku (grant root or wireless debugging permission)
Open Android MCP app → grant Shizuku permission → tap Start
Notification shows "MCP service running" on port 18080

4. Start Server

# One-click (SSE + Web GUI + ADB forward)
./start.sh

# Windows
start.bat

Opens browser at http://127.0.0.1:8080.

5. Connect MCP Client

In the Web GUI, open Menu → Setup to see your MCP addresses:

Client	Endpoint
Kai 9000 (phone)	`http://192.168.x.x:9000/mcp`
Claude Desktop (remote)	`http://192.168.x.x:9000/sse`
Same device (Termux)	`http://127.0.0.1:9000/sse` or `/mcp`

Add the address in Kai 9000 (Settings → MCP Servers → Add) or Claude Desktop:

{
  "mcpServers": {
    "android": {
      "command": "python",
      "args": ["-m", "android_mcp.main", "--mode", "mcp"]
    }
  }
}

Now chat with the AI to control your phone — "open settings", "take a screenshot", "click the search button".

⚙️ Configuration

Edit .env:

# Device connection
ANDROID_HOST=127.0.0.1
ANDROID_PORT=18080

# Web GUI
WEB_HOST=127.0.0.1
WEB_PORT=8080

# MCP Server (SSE + Streamable HTTP) — for Kai 9000 & other clients
# Use 0.0.0.0 to accept WiFi/phone connections; 127.0.0.1 for local-only
MCP_HOST=0.0.0.0
MCP_PORT=9000

# AI Vision (optional — enables AI chat + element recognition)
VISION_PROVIDER=anthropic       # anthropic | openai | custom
VISION_API_KEY=sk-ant-api03-xxxxx
VISION_MODEL=                   # leave empty for default
VISION_API_BASE=                # only for custom provider

🖥️ CLI Commands

# Start modes
python -m android_mcp.main --mode all-sse   # SSE + Streamable HTTP + Web GUI (default)
python -m android_mcp.main --mode mcp       # stdio only (Claude Desktop)
python -m android_mcp.main --mode mcp-sse   # SSE + Streamable HTTP (headless)
python -m android_mcp.main --mode mcp-http  # Streamable HTTP only
python -m android_mcp.main --mode web       # Web GUI only

# Process management
python -m android_mcp.gateway start         # Start as daemon
python -m android_mcp.gateway status        # Check status
python -m android_mcp.gateway stop          # Stop daemon
python -m android_mcp.gateway forward       # Set up ADB port forward

📁 Project Structure

android-mcp/
├── android_mcp/
│   ├── server.py          # FastMCP server definition
│   ├── main.py            # Entry point
│   ├── config.py          # Environment config
│   ├── bridge.py          # HTTP bridge to Android
│   ├── gateway.py         # CLI process manager
│   ├── tools/             # MCP tool implementations (by domain)
│   │   ├── device.py      # Health, info, screenshot
│   │   ├── input.py       # Touch, swipe, keys
│   │   ├── apps.py        # Package management
│   │   ├── system.py      # Shell, settings, clipboard
│   │   ├── files.py       # File read/write
│   │   └── vision.py      # AI element recognition
│   ├── vision/            # Vision model clients
│   │   ├── models.py      # Data classes + Protocol
│   │   ├── clients.py     # Anthropic + OpenAI clients
│   │   └── prompts.py     # Prompt builder + parser
│   └── web/               # Web GUI
│       ├── server.py      # FastAPI + WebSocket
│       ├── chat_agent.py  # AI chat → tool execution
│       ├── scrcpy_bridge.py # scrcpy + frame streaming
│       └── static/        # HTML/CSS/JS frontend
├── android/               # Android APK project
│   ├── app/src/main/
│   │   ├── java/com/example/androidmcp/
│   │   │   ├── App.kt             # Application class
│   │   │   ├── MainActivity.kt    # Main UI + Shizuku auth
│   │   │   ├── McpService.kt      # Foreground service
│   │   │   ├── api/
│   │   │   │   ├── FileApi.kt     # File read/write/delete
│   │   │   │   ├── InputApi.kt    # Touch, swipe, key events
│   │   │   │   ├── PackageApi.kt  # App install/uninstall
│   │   │   │   ├── ShellApi.kt    # Shell command execution
│   │   │   │   └── SystemApi.kt   # Screenshot, clipboard, settings
│   │   │   ├── server/
│   │   │   │   ├── HttpServer.kt  # Embedded HTTP server (:18080)
│   │   │   │   └── Router.kt      # JSON-RPC method dispatch
│   │   │   └── util/
│   │   │       └── ShizukuHelper.kt # Shizuku binder wrapper
│   │   └── res/                   # Layout, drawable, strings
│   ├── gradle/                    # Gradle wrapper
│   ├── build.gradle.kts
│   └── settings.gradle.kts
├── scripts/setup.sh       # First-time setup
├── start.sh               # One-click start
├── start.bat              # Windows launcher
├── pyproject.toml
└── .env.example

📋 Requirements

Component	Requirement
Python	3.10+
Android	11+ (API 30+)
Android App	Shizuku installed and running
ADB	Platform Tools (for port forward)
scrcpy	Optional (native mirroring)
AI Vision	Anthropic/OpenAI API key (optional)
MCP Client	Kai 9000 (F-Droid), Claude Desktop, or any SSE/stdio MCP client

📄 License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

ADB MCP Server
Shell Access App Automation Testing & QA Tools
LLL-404
F
license
A
quality
C
maintenance
A MCP server that enables AI assistants to control Android devices via ADB, supporting device info, screen control, input simulation, app management, shell execution, file transfer, and UI parsing.
Last updated 2026-05-26
20
scrcpy-mcp
Shell Access File Systems OS Automation
JuanCF
A
license
A
quality
B
maintenance
MCP server that gives AI agents full vision and control over Android devices via ADB and scrcpy. Supports screenshots, input, apps, UI automation, shell, files, and clipboard.
Last updated 2026-07-06
38
227
59
MIT
uiautomator2 MCP Server
OS Automation App Automation
tanbro
A
license
-
quality
A
maintenance
An MCP server that provides tools for controlling Android devices using uiautomator2, enabling AI to automate tasks like tapping, swiping, and managing apps.
Last updated 2026-07-21
33
Apache 2.0
phone-mcp-server
App Automation Autonomous Agents
Ctrl-Creeper
A
license
-
quality
B
maintenance
Enables AI agents to control Android phones via MCP and HTTP. Supports screen capture, taps, swipes, text input, and app management.
Last updated 2026-06-30
AGPL 3.0

View all related MCP servers

Related MCP Connectors

TVWizard
Control Android TV from any AI. 38 MCP tools: playback, recap, recommend, smart-home, schedules.
Remote Desktop Commander
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer
hithereiamaliff-mcp-nextcloud
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/shuao-pro/android-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Android MCP Server

🏗️ Architecture

✨ Features

Device Control (29 MCP Tools)

AI Vision

Web Dashboard

MCP Clients

MCP Transport

🔗 Links

🚀 Quick Start

Prerequisites

1. Install

2. Setup

3. On Your Phone

4. Start Server

5. Connect MCP Client

⚙️ Configuration

🖥️ CLI Commands

📁 Project Structure

📋 Requirements

📄 License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

ADB MCP Server

scrcpy-mcp

uiautomator2 MCP Server

phone-mcp-server

Related MCP Connectors

Latest Blog Posts

MCP directory API