[{"_1":2,"_308":-5,"_309":-5},"loaderData",{"_3":4,"_29":30,"_220":221},"root",{"_5":6,"_14":15},"toasts",[7],{"_8":9,"_10":11,"_12":13},"uid","019a3345-aa9d-70a8-8c2b-91448ead6ece","title","You need to sign in to access this page","type","error","visitor",{"_16":17,"_18":19},"viewportWidth",1280,"visitorSession",{"_20":21,"_23":24,"_25":-5,"_26":27,"_28":-5},"attributes",[22],"bot","id",21617481,"membership","referenceId","019a2dfc-1dad-704d-a3b8-88a103e988d5","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_31":32,"_33":-5,"_34":35,"_36":47,"_136":137,"_218":219},"availableLocales",[],"githubUser","locale",{"_36":37,"_40":44,"_45":46},"mcpServer",{"_38":39,"_40":41,"_42":43},"description","Enables AI agents to interact with Android devices through visual UI element detection and automated interactions. Provides comprehensive Android automation capabilities including touch gestures, text input, screenshots, and video recording via uiautomator2.","name","Android Puppeteer","readme","mcp-name: io.github.pedro-rivas/android-puppeteer-mcp\n\n

\n\n

Android Puppeteer

\n\n \n $\"License\"$ \n \n $\"Python\"$ \n $\"Platform\"$ \n $\"MCP$ \n\n

\n\n
\n\n**Android Puppeteer** is a lightweight, visual-first MCP (Model Context Protocol) server that enables AI agents to interact with Android devices through intelligent UI element detection and automated interactions. Built on uiautomator2, it provides comprehensive Android automation capabilities including visual element detection, touch interactions, text input, and video recording.\n\n🎥 **[Watch the demo in action](https://www.linkedin.com/feed/update/urn:li:activity:7373122958866825216/)**\n\n## Features\n\n- **Visual Element Detection**\n Automatically detects and annotates interactive UI elements with numbered overlays for precise targeting.\n\n- **Comprehensive Touch Interactions**\n Support for tap, long press, swipe, scroll, and drag gestures with coordinate-based precision.\n\n- **Multi-Device Support**\n Connect to multiple Android devices or emulators simultaneously with device-specific targeting.\n\n- **Video Recording Integration**\n Built-in screen recording capabilities using scrcpy for documentation and testing workflows.\n\n- **Real-Time UI Analysis**\n Live UI hierarchy parsing and element information extraction for dynamic interaction strategies.\n\n- **MCP Protocol Integration**\n Seamless integration with Claude Desktop and other MCP-compatible AI platforms.\n\n### Supported Operating Systems\n\n- Android 10+\n- Windows, macOS, Linux (host systems)\n\n## Installation\n\n### Prerequisites\n\n- Python 3.10+\n- uiautomator2\n- Android 10+ (Emulator or Physical Device)\n- ADB (Android Debug Bridge)\n- scrcpy (for video recording features)\n\n### Getting Started\n\n1. **Clone the repository**\n\n```shell\ngit clone https://github.com/pedro-rivas/android-puppeteer-mcp.git\ncd android-puppeteer\n```\n\n2. **Install dependencies**\n\n```shell\nuv python install 3.10\nuv sync\n```\n\n3. **Setup Android device**\n\n```shell\n# Enable USB debugging on your Android device\n# For emulator, ensure it's running\nadb devices # Verify device connection\n```\n\n4. **Connect to the MCP server**\n\n1. Locate your Claude Desktop configuration file:\n\n - Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n2. Add the following JSON to your Claude Desktop config:\n\n ```json\n {\n \"mcpServers\": {\n \"android-puppeteer\": {\n \"command\": \"path/to/uv\",\n \"args\": [\n \"--directory\",\n \"path/to/android-puppeteer\",\n \"run\",\n \"puppeteer.py\"\n ]\n }\n }\n }\n ```\n Replace:\n - `path/to/uv` with the actual path to your uv executable\n - `path/to/android-puppeteer` with the absolute path to where you have cloned this repo\n\n3. **Restart Claude Desktop**\n\nRestart your Claude Desktop. You should see \"android-puppeteer\" listed as an available integration.\n\n---\n\n## Available Tools\n\nAndroid Puppeteer provides the following tools for comprehensive Android device interaction:\n\n### Device Management\n- **`list_emulators`**: List all available Android emulators and devices with their status and dimensions\n- **`get_device_dimensions`**: Get the screen dimensions of a specific Android device\n- **`get_ui_elements_info`**: Get detailed information about all interactive UI elements on screen\n\n### Visual Interaction\n- **`take_screenshot`**: Capture annotated screenshots with numbered UI element overlays\n- **`press`**: Tap on specific coordinates with optional long press duration\n- **`long_press`**: Perform long press gestures on specific coordinates\n\n### Navigation & Input\n- **`press_back`**: Press the hardware back button\n- **`swipe`**: Perform directional or custom coordinate swipes\n- **`type_text`**: Type text into focused input fields with optional text clearing\n- **`scroll_element`**: Scroll specific UI elements in any direction\n\n### Recording & Documentation\n- **`record_video`**: Start screen recording with customizable quality settings\n- **`stop_video`**: Stop active screen recordings and save to local storage\n\n## Usage Examples\n\n### Basic Device Interaction\n\n```python\n# Take an annotated screenshot\nscreenshot = await take_screenshot()\n\n# Tap on a specific element (element 5 from screenshot)\nawait press(x=500, y=300)\n\n# Type text into an input field\nawait type_text(\"Hello, Android!\")\n\n# Swipe to scroll down\nawait swipe(direction=\"down\")\n```\n\n### Multi-Device Automation\n\n```python\n# List available devices\ndevices = await list_emulators()\n\n# Target specific device\nawait take_screenshot(device_id=\"emulator-5554\")\nawait press(x=200, y=400, device_id=\"emulator-5554\")\n```\n\n### Video Recording Workflow\n\n```python\n# Start recording\nawait record_video(filename=\"test_session.mp4\")\n\n# Perform automation steps\nawait press(x=300, y=500)\nawait type_text(\"Automated test input\")\n\n# Stop recording\nawait stop_video()\n```\n\n## Project Structure\n\n```\nandroid-puppeteer/\n puppeteer.py # Main MCP server implementation\n main.py # Entry point\n pyproject.toml # Project configuration\n ss/ # Screenshots directory\n videos/ # Video recordings directory\n README.md # This file\n```\n\n## Important Notes\n\n- **Device Permissions**: Ensure USB debugging is enabled on target Android devices\n- **Network Access**: Some features require network connectivity for device communication\n- **Storage**: Screenshot and video files are saved locally in `ss/` and `videos/` directories\n- **Performance**: Response times depend on device performance and network latency\n\n## Troubleshooting\n\n### Common Issues\n\n1. **Device not found**: Verify ADB connection with `adb devices`\n2. **Permission denied**: Check USB debugging and device authorization\n3. **Screenshot failures**: Ensure device screen is unlocked and accessible\n4. **Video recording issues**: Verify scrcpy installation and device compatibility\n\n### Debug Mode\n\nRun the server directly for debugging:\n```shell\nuv run puppeteer.py\n```\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 feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n### Development Setup\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Make your changes\n4. Run tests and ensure code quality\n5. Commit your changes (`git commit -m 'Add amazing feature'`)\n6. Push to the branch (`git push origin feature/amazing-feature`)\n7. Open a Pull Request\n\n## Related Projects\n\n- [Android MCP](https://github.com/CursorTouch/Android-MCP) - Alternative Android automation MCP server\n- [uiautomator2](https://github.com/openatx/uiautomator2) - Core Android automation library\n- [MCP Protocol](https://modelcontextprotocol.io/) - Model Context Protocol specification\n\n---\n\n**Star this repo if you find it useful!** ","English","tag","en-US",{"_48":49,"_20":50,"_59":39,"_60":39,"_23":61,"_62":63,"_40":41,"_74":75,"_82":-5,"_83":-5,"_84":85,"_124":125,"_130":-5,"_70":108,"_131":132,"_8":133,"_134":135},"addedAt","2025-09-15T03:00:57.629689Z",[51,52,53,54,55,56,57,58],"category:os-automation","category:app-automation","category:developer-tools","environment:local","hosting:local-only","language:python","security_grade:a","quality_grade:a","descriptionMarkdown","descriptionPlainText",11556,"integrations",[64],{"_65":66,"_38":72,"_8":73},"brand",{"_67":68,"_40":69,"_70":71},"logoSvgPath","M18.4395 5.5586c-.675 1.1664-1.352 2.3318-2.0274 3.498-.0366-.0155-.0742-.0286-.1113-.043-1.8249-.6957-3.484-.8-4.42-.787-1.8551.0185-3.3544.4643-4.2597.8203-.084-.1494-1.7526-3.021-2.0215-3.4864a1.1451 1.1451 0 0 0-.1406-.1914c-.3312-.364-.9054-.4859-1.379-.203-.475.282-.7136.9361-.3886 1.5019 1.9466 3.3696-.0966-.2158 1.9473 3.3593.0172.031-.4946.2642-1.3926 1.0177C2.8987 12.176.452 14.772 0 18.9902h24c-.119-1.1108-.3686-2.099-.7461-3.0683-.7438-1.9118-1.8435-3.2928-2.7402-4.1836a12.1048 12.1048 0 0 0-2.1309-1.6875c.6594-1.122 1.312-2.2559 1.9649-3.3848.2077-.3615.1886-.7956-.0079-1.1191a1.1001 1.1001 0 0 0-.8515-.5332c-.5225-.0536-.9392.3128-1.0488.5449zm-.0391 8.461c.3944.5926.324 1.3306-.1563 1.6503-.4799.3197-1.188.0985-1.582-.4941-.3944-.5927-.324-1.3307.1563-1.6504.4727-.315 1.1812-.1086 1.582.4941zM7.207 13.5273c.4803.3197.5506 1.0577.1563 1.6504-.394.5926-1.1038.8138-1.584.4941-.48-.3197-.5503-1.0577-.1563-1.6504.4008-.6021 1.1087-.8106 1.584-.4941z","Android","slug","android","Enables AI agents to interact with Android devices through visual UI element detection, touch interactions, text input, navigation gestures, and screen recording capabilities using uiautomator2 automation.","7spyiuc8z5","namespace",{"_76":77,"_70":81},"owner",{"_78":79},"githubAccount",{"_80":81},"login","pedro-rivas","readmeMarkdown","redditPostExternalId","repository",{"_86":87,"_93":94,"_97":98,"_115":-5,"_116":117,"_118":-5,"_119":120},"argumentsJsonSchema",{"_88":89,"_90":91,"_12":92},"properties",{},"required",[],"object","githubProject",{"_42":43,"_95":96},"url","https://github.com/pedro-rivas/android-puppeteer-mcp","githubRepository",{"_99":100,"_101":102,"_103":104,"_23":105,"_106":107,"_40":108,"_76":109,"_111":112,"_113":-5,"_114":112},"defaultBranch","main","fullName","pedro-rivas/android-puppeteer-mcp","githubTreeId",251163,26765,"language","Python","android-puppeteer-mcp",{"_80":81,"_8":110},"p0kb8gsa81","recentStargazers",0,"spdxLicense","stargazers","glamaJson","inspectable",true,"npmPackage","supportedPlatforms",[121,122,123],"WINDOWS","MACOS","LINUX","scores",{"_126":-5,"_127":128,"_129":128},"license","quality",100,"security","simpleIcon","toolCount",12,"nnz88rr9rr","updatedAt","2025-10-03T02:15:41.899427Z","meta",[138,140,142,149,152,154,157,160,163,166,169,171,174,177,179,181,183,185,187],{"_10":139},"Android Puppeteer | Glama",{"_141":39,"_40":38},"content",{"_143":144,"_145":146,"_147":148},"href","https://glama.ai/mcp/servers/@pedro-rivas/android-puppeteer-mcp","rel","canonical","tagName","link",{"_141":41,"_150":151},"property","og:title",{"_141":39,"_150":153},"og:description",{"_141":155,"_150":156},"https://glama.ai/logo.png","og:logo",{"_141":158,"_150":159},"https://glama.ai/mcp/servers/@pedro-rivas/android-puppeteer-mcp/og-image","og:image",{"_141":161,"_150":162},"630","og:image:height",{"_141":164,"_150":165},"1200","og:image:width",{"_141":167,"_150":168},"website","og:type",{"_141":144,"_150":170},"og:url",{"_141":172,"_150":173},"Glama – MCP Hosting Platform","og:site_name",{"_141":175,"_40":176},"summary_large_image","twitter:card",{"_141":172,"_40":178},"twitter:title",{"_141":39,"_40":180},"twitter:description",{"_141":158,"_40":182},"twitter:image",{"_141":161,"_40":184},"twitter:image:height",{"_141":164,"_40":186},"twitter:image:width",{"_188":189},"script:ld+json",{"_190":191,"_192":193},"@context","http://schema.org","@graph",[194],{"_190":195,"_196":197,"_198":199},"https://schema.org","@type","BreadcrumbList","itemListElement",[200,207,211,215],{"_196":201,"_202":203,"_40":204,"_205":206},"ListItem","item","/","Glama","position",1,{"_196":201,"_202":208,"_40":209,"_205":210},"/mcp","MCP",2,{"_196":201,"_202":212,"_40":213,"_205":214},"/mcp/servers","Servers",3,{"_196":201,"_202":216,"_40":41,"_205":217},"/mcp/servers/@pedro-rivas/android-puppeteer-mcp",4,"visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_222":223,"_36":229,"_246":247,"_136":258,"_256":282,"_283":284},"blob",{"_141":224,"_225":226,"_227":228},"# Python-generated files\n__pycache__/\n*.py[oc]\nbuild/\ndist/\nwheels/\n*.egg-info\n\n# Virtual environments\n.venv\n\n# MCP Registry tokens\n.mcpregistry_github_token\n.mcpregistry_registry_token\n","fileName",".gitignore","size",186,{"_48":49,"_20":230,"_59":39,"_60":39,"_23":61,"_62":231,"_40":41,"_74":234,"_82":-5,"_83":-5,"_84":237,"_124":245,"_130":-5,"_70":108,"_131":132,"_8":133,"_134":135},[51,52,53,54,55,56,57,58],[232],{"_65":233,"_38":72,"_8":73},{"_67":68,"_40":69,"_70":71},{"_76":235,"_70":81},{"_78":236},{"_80":81},{"_86":238,"_93":241,"_97":242,"_115":-5,"_116":117,"_118":-5,"_119":244},{"_88":239,"_90":240,"_12":92},{},[],{"_42":43,"_95":96},{"_99":100,"_101":102,"_103":104,"_23":105,"_106":107,"_40":108,"_76":243,"_111":112,"_113":-5,"_114":112},{"_80":81,"_8":110},[121,122,123],{"_126":-5,"_127":128,"_129":128},"member",{"_248":249,"_252":253,"_254":226,"_103":104,"_255":219,"_256":226,"_257":117,"_227":228,"_12":222},"commit",{"_250":251},"sha","94bf75ff82883c46692896aa7e447cb4af52c57e","contentStoredObjectPointerId",10948208,"fullPath","indexable","path","safeToDisplayAsText",[259,261,263,265,267,268,269,271,272,273,274,275,276,277,278,279,280,281],{"_10":260},".gitignore | Android Puppeteer | Glama",{"_141":262,"_40":38},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_143":264,"_145":146,"_147":148},"https://glama.ai/mcp/servers/@pedro-rivas/android-puppeteer-mcp/blob/94bf75ff82883c46692896aa7e447cb4af52c57e/",{"_141":266,"_150":151},".gitignore | Android Puppeteer",{"_141":262,"_150":153},{"_141":155,"_150":156},{"_141":270,"_150":159},"https://glama.ai/generated-images/og?title=.gitignore+%7C+Android+Puppeteer",{"_141":161,"_150":162},{"_141":164,"_150":165},{"_141":167,"_150":168},{"_141":264,"_150":170},{"_141":172,"_150":173},{"_141":175,"_40":176},{"_141":172,"_40":178},{"_141":262,"_40":180},{"_141":270,"_40":182},{"_141":161,"_40":184},{"_141":164,"_40":186},"","treeMembers",[285,287,290,293,296,299,302,305],{"_248":286,"_254":226,"_256":226,"_12":222},{"_250":251},{"_248":288,"_254":289,"_256":289,"_12":222},{"_250":251},"main.py",{"_248":291,"_254":292,"_256":292,"_12":222},{"_250":251},"puppeteer.py",{"_248":294,"_254":295,"_256":295,"_12":222},{"_250":251},"pyproject.toml",{"_248":297,"_254":298,"_256":298,"_12":222},{"_250":251},".python-version",{"_248":300,"_254":301,"_256":301,"_12":222},{"_250":251},"README.md",{"_248":303,"_254":304,"_256":304,"_12":222},{"_250":251},"server.json",{"_248":306,"_254":307,"_256":307,"_12":222},{"_250":251},"uv.lock","actionData","errors"]

MCP directory API