{"id":35094085,"url":"https://github.com/CursorTouch/Android-MCP","last_synced_at":"2026-01-01T23:01:04.022Z","repository":{"id":298648892,"uuid":"1000066977","full_name":"CursorTouch/Android-MCP","owner":"CursorTouch","description":"Lightweight MCP Server for interacting with Android Operating System.","archived":false,"fork":false,"pushed_at":"2025-09-02T07:48:14.000Z","size":91,"stargazers_count":44,"open_issues_count":1,"forks_count":9,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-02T09:28:55.987Z","etag":null,"topics":["ai","android","automation","mcp-server"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CursorTouch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-11T08:06:30.000Z","updated_at":"2025-09-02T07:48:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"b263d89c-a2e6-4128-ada9-57c5feca8e20","html_url":"https://github.com/CursorTouch/Android-MCP","commit_stats":null,"previous_names":["cursortouch/android-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CursorTouch/Android-MCP","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CursorTouch%2FAndroid-MCP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CursorTouch%2FAndroid-MCP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CursorTouch%2FAndroid-MCP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CursorTouch%2FAndroid-MCP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CursorTouch","download_url":"https://codeload.github.com/CursorTouch/Android-MCP/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CursorTouch%2FAndroid-MCP/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28165027,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2026-01-01T02:00:06.694Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","android","automation","mcp-server"],"created_at":"2025-12-27T15:04:24.311Z","updated_at":"2026-01-01T23:01:04.016Z","avatar_url":"https://github.com/CursorTouch.png","language":"Python","funding_links":[],"categories":["📚 Projects (1974 total)"],"sub_categories":["MCP Servers"],"readme":"\u003cdiv align=\"center\"\u003e\n\n  \u003ch1\u003e🤖 Android MCP\u003c/h1\u003e\n\n  \u003ca href=\"https://github.com/CursorTouch/Android-MCP/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/license-MIT-green\" alt=\"License\"\u003e\n  \u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/python-3.12%2B-blue\" alt=\"Python\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-Android%2010+-blue\" alt=\"Platform\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/last-commit/CursorTouch/Android-MCP\" alt=\"Last Commit\"\u003e\n  \u003cbr\u003e\n  \u003ca href=\"https://x.com/CursorTouch\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/follow-%40CursorTouch-1DA1F2?logo=twitter\u0026style=flat\" alt=\"Follow on Twitter\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://discord.com/invite/Aue9Yj2VzS\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Join%20on-Discord-5865F2?logo=discord\u0026logoColor=white\u0026style=flat\" alt=\"Join us on Discord\"\u003e\n  \u003c/a\u003e\n\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n**Android-MCP** is a lightweight, open-source tool that bridge between AI agents and Android devices. Running as an MCP server, it lets LLM agents perform real-world tasks such as **app navigation, UI interaction and automated QA testing** without relying on traditional computer-vision pipelines or preprogramed scripts.\n\n\u003chttps://github.com/user-attachments/assets/cf9a5e4e-b69f-46d4-8487-0f61a7a86d67\u003e\n\n## ✨ Features\n\n- **Native Android Integration**  \n  Interact with UI elements via ADB and the Android Accessibility API: launch apps, tap, swipe, input text, and read view hierarchies.\n\n- **Bring Your Own LLM/VLM**  \n  Works with any language model, no fine-tuned CV model or OCR pipeline required.\n\n- **Rich Toolset for Mobile Automation**  \n  Pre-built tools for gestures, keystrokes, capture, device state, shell commands execution.\n\n- **Real-Time Interaction**  \n  Typical latency between actions (e.g., two taps) ranges **2-4s** depending on device specs and load.\n\n### Supported Operating Systems\n\n- Android 10+\n\n## Installation\n\n### 📦 Prerequisites\n\n- Python 3.10+\n- ADB (Android Debug Bridge)\n- Android 10+ (Emulator/ Android Device)\n\n### 📲 Testing ADB Connection\n\nBefore running the server, ensure your Android device is connected and recognized by ADB:\n\n1. Connect your Android device via USB or ensure your emulator is running.\n2. Open a terminal and run:\n   ```shell\n   adb devices\n   ```\n3. You should see your device listed:\n   ```\n   List of devices attached\n   emulator-5554   device\n   ```\n   If the list is empty or shows \"unauthorized\", check your USB debugging settings on the device.\n\n### 🏁 Getting Started\n\nYou can run the Android MCP server using **UVX** (recommended) or **UV** (for local development).\n\n#### Option 1: UVX (Recommended)\n\nNo need to install dependencies manually. Just configure Claude Desktop:\n\n1. **Locate your config file**\n   - Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n2. **Add the configuration**\n   ```json\n   {\n     \"mcpServers\": {\n       \"android-mcp\": {\n         \"command\": \"uvx\",\n         \"args\": [\n           \"android-mcp\"\n         ]\n       }\n     }\n   }\n   ```\n   \u003e **Note:** By default, it connects to `emulator-5554`. To connect to a specific device, add `\"--device\", \"\u003cYOUR_DEVICE_serial\u003e\"` to the args list.\n\n#### Option 2: UV Mode (Local Development)\n\n1. **Clone and Install**\n   ```shell\n   git clone https://github.com/CursorTouch/Android-MCP.git\n   cd Android-MCP\n   uv sync\n   ```\n\n2. **Configure Claude Desktop**\n   ```json\n   {\n     \"mcpServers\": {\n       \"android-mcp\": {\n         \"command\": \"uv\",\n         \"args\": [\n           \"--directory\",\n           \"\u003c/PATH/TO/Android-MCP\u003e\",\n           \"run\",\n           \"android-mcp\"\n         ]\n       }\n     }\n   }\n   ```\n   \u003e **Note:** Replace `\u003c/PATH/TO/Android-MCP\u003e` with the full path to your cloned directory. Add `\"--device\", \"\u003cYOUR_DEVICE_serial\u003e\"` to args to target a specific device.\n\n3. **Restart the Claude Desktop**\n\nRestart your Claude Desktop. You should see \"android-mcp\" listed as an available integration. That's it, now you're ready to start controlling your Android device with natural language.\n\nFor troubleshooting tips (log locations, common ADB issues), see the [MCP docs](https://modelcontextprotocol.io/quickstart/server#android-mcp-integration-issues).\n\n---\n\n## 🛠️ Available Tools\n\nClaude can access the following tools to interact with Windows:\n\n- `State-Tool`: To understand the state of the device.\n- `Click-Tool`: Click on the screen at the given coordinates.\n- `Long-Click-Tool`: Perform long click on the screen at the given coordinates.\n- `Type-Tool`: Type text on the specified coordinates (optionally clears existing text).\n- `Swipe-Tool`: Perform swipe from one location to other.\n- `Drag-Tool`: Drag from one point to another.\n- `Press-Tool`: To press the keys on the mobile device (Back, Volume Up, ...etc).\n- `Wait-Tool`: Pause for a defined duration.\n- `State-Tool`: Combined snapshot of active apps and interactive UI elements.\n- `Notification-Tool`: To access the notifications seen on the device.\n- `Shell-Tool`: To execute shell commands on the android device.\n\n## ⚠️ Caution\n\nAndroid-MCP can execute arbitrary UI actions on your mobile device. Use it in controlled environments (emulators, test devices) when running untrusted prompts or agents.\n\n## 🪪 License\n\nThis project is licensed under the MIT License. See [LICENSE](LICENSE) for details.\n\n## 🤝 Contributing\n\nContributions are welcome! Please read [CONTRIBUTING](CONTRIBUTING) for dev setup and PR guidelines.\n\nMade with ❤️ by [CursorTouch](https://github.com/cursortouch), \n\ndevelopers: [Jeomon George](https://github.com/jeomon), [Muhammad Yaseen](https://github.com/mhmdyaseen)\n\n## Citation\n\n```bibtex\n@misc{\n  author       = {cursortouch},\n  title        = {Android-MCP},\n  year         = {2025},\n  publisher    = {GitHub},\n  howpublished = {\\url{https://github.com/CursorTouch/Android-MCP}},\n  note         = {Lightweight open-source bridge between LLM agents and Android},\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCursorTouch%2FAndroid-MCP","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCursorTouch%2FAndroid-MCP","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCursorTouch%2FAndroid-MCP/lists"}