DroidMind
Control Android devices with AI through the Model Context Protocol via ADB.
Add to your client
Copy the config for your MCP client and paste it into its config file.
Paste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"droidmind": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/hyperb1iss/droidmind",
"droidmind",
"--transport",
"stdio"
]
}
}
}Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.
Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- Python 3.13 (3.14 not yet supported)
- uv (Python package manager)
- Android device with USB debugging enabled
- ADB (Android Debug Bridge) installed and in your system's PATH
About DroidMind
DroidMind connects AI assistants to Android devices over ADB through the Model Context Protocol. It enables device management, system diagnostics, file operations, app management, shell command execution, and UI automation from natural-language requests, all wrapped in a security-conscious framework. It runs via uvx with zero manual install (stdio) or as an SSE server, and integrates with any MCP-compatible client such as Claude, Cursor, and Cline.
Tools & capabilities (8)
android-deviceDevice management operations: list_devices, connect_device (TCP/IP over Wi-Fi), disconnect_device, device_properties, and reboot_device (normal/recovery/bootloader).
android-diagDiagnostics operations: capture_bugreport (comprehensive bug report, optionally with screenshots) and dump_heap (Java or native heap dump from a running process).
android-logLog retrieval: get_device_logcat, get_app_logs (filtered by package), get_anr_logs, get_crash_logs, and get_battery_stats.
android-fileFile and directory operations: list_directory, push_file, pull_file, delete_file, create_directory, file_exists, read_file, write_file, and file_stats.
android-appApplication management: install_app, uninstall_app, start_app, stop_app, clear_app_data, list_packages, get_app_manifest, get_app_permissions, get_app_activities, and get_app_info.
android-shellExecutes an arbitrary ADB shell command on the device, with optional limits on output lines and size.
android-uiUI automation: tap, swipe, input_text, press_key (Android keycodes), and start_intent (launch an activity with optional intent extras).
android-screenshotCaptures a screenshot from the device, with configurable JPEG quality (1-100, default 75).
When to use it
- List connected Android devices and inspect their system properties
- Capture screenshots, crash logs, and bug reports while debugging an app on a real device
- Install, start, stop, and inspect APKs (manifest, permissions, activities) from an AI coding workflow
- Automate UI flows by tapping, swiping, entering text, and pressing keys
- Push, pull, read, write, and delete files on a device through natural language
Security notes
DroidMind includes a security framework: command validation and sanitization, risk assessment categorization, protected path operations, and comprehensive logging. High-risk operations are flagged and critical ones are blocked by default. Because it controls a real Android device over ADB (including shell execution and file write/delete), grant it access only to devices and data you trust.
DroidMind FAQ
Do I need to install DroidMind before using it?
No. The recommended quickstart uses uvx to run DroidMind directly from its GitHub repository, so you don't need to clone or install it manually. Manual installation from source and a Docker option are also documented.
Which transports are supported?
stdio (the default and preferred mode for most IDE integrations) and SSE (for web UIs or assistants like Claude Desktop, typically at sse://localhost:4256/sse).
Is it safe to give an AI control of my device?
DroidMind adds a security framework with command validation and sanitization, risk assessment, protected path operations, and logging. High-risk operations are flagged and critical ones are blocked by default, but you should still only connect devices and data you trust.
Alternatives to DroidMind
Compare all alternatives →
Microsoft's official browser-automation MCP using Playwright's accessibility tree (no vision model).
Up-to-date, version-specific library documentation injected into your coding agent.
LSP-powered coding agent toolkit: semantic symbol search, references and structural edits.
Compare DroidMind with: