How to add DroidMind to Claude Desktop

Control Android devices with AI through the Model Context Protocol via ADB. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 406★ · stdio · no auth

Claude Desktop config for DroidMind

{
  "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.

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the DroidMind config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm DroidMind's tools appear under the 🔌 tools menu.

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

What DroidMind can do in Claude Desktop

android-device

Device management operations: list_devices, connect_device (TCP/IP over Wi-Fi), disconnect_device, device_properties, and reboot_device (normal/recovery/bootloader).

android-diag

Diagnostics operations: capture_bugreport (comprehensive bug report, optionally with screenshots) and dump_heap (Java or native heap dump from a running process).

android-log

Log retrieval: get_device_logcat, get_app_logs (filtered by package), get_anr_logs, get_crash_logs, and get_battery_stats.

android-file

File and directory operations: list_directory, push_file, pull_file, delete_file, create_directory, file_exists, read_file, write_file, and file_stats.

android-app

Application 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-shell

Executes an arbitrary ADB shell command on the device, with optional limits on output lines and size.

android-ui

UI automation: tap, swipe, input_text, press_key (Android keycodes), and start_intent (launch an activity with optional intent extras).

android-screenshot

Captures a screenshot from the device, with configurable JPEG quality (1-100, default 75).

Security

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 + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the DroidMind config there under the "mcpServers" key and restart the client.

Is DroidMind safe to use with Claude Desktop?

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.

View repo Full DroidMind page