DroidMind

v1.0.0Developer Toolsstable

A Model Context Protocol (MCP) server that enables AI assistants to control and interact with Android devices, allowing for device management, app debugging, system analysis, and UI automation through natural language commands.

adbaiandroidclaudecontext
Share:
399
Stars
0
Downloads
0
Weekly
0/5

What is DroidMind?

DroidMind is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server that enables ai assistants to control and interact with android devices, allowing for device management, app debugging, system analysis, and ui automation through n...

A Model Context Protocol (MCP) server that enables AI assistants to control and interact with Android devices, allowing for device management, app debugging, system analysis, and UI automation through natural language commands.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol (MCP) server that enables AI assist

Use Cases

Android device automation
App debugging via MCP
System analysis and UI control
hyperb1iss

Maintainer

LicenseApache 2.0
Languagepython
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y droidmind

Manual Installation

npx -y droidmind

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use DroidMind

DroidMind is a Python-based MCP server that enables AI assistants to control and interact with Android devices via ADB (Android Debug Bridge). It exposes a comprehensive set of tools for device management, app installation and control, file operations, UI automation, shell command execution, and system analysis including logcat and crash log retrieval. Developers use DroidMind to automate Android testing, debug apps through natural language, and perform remote device management directly from their AI coding assistant.

Prerequisites

  • Python 3.13 (note: Python 3.14 is not supported)
  • uv package manager installed (provides the uvx command)
  • ADB (Android Debug Bridge) installed and accessible in your system PATH
  • An Android device or emulator with USB debugging enabled in Developer Options
  • An MCP-compatible client such as Claude Desktop or Cursor
1

Install ADB and Enable USB Debugging

Install Android platform tools which include ADB. Then enable Developer Options on your Android device (tap Build Number 7 times in Settings > About Phone) and enable USB Debugging.

# macOS (via Homebrew):
brew install android-platform-tools

# Ubuntu/Debian:
sudo apt-get install android-tools-adb

# Verify ADB is working:
adb devices
2

Install uv Package Manager

DroidMind is run via uvx, which is part of the uv Python package manager. Install uv if you don't have it already.

curl -LsSf https://astral.sh/uv/install.sh | sh

# Verify installation:
uvx --version
3

Connect Your Android Device

Connect your Android device via USB and confirm ADB can see it. Approve the USB debugging prompt on the device.

adb devices
# Expected output:
# List of devices attached
# your_device_serial    device
4

Configure Claude Desktop

Add DroidMind to your Claude Desktop configuration. The server runs directly from GitHub via uvx in stdio transport mode.

{
  "mcpServers": {
    "droidmind": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/hyperb1iss/droidmind",
        "droidmind",
        "--transport",
        "stdio"
      ]
    }
  }
}
5

Or Run in SSE Mode for Web Clients

For clients that support SSE transport, run DroidMind as a standalone server. It starts on localhost:4256 by default.

uvx --from git+https://github.com/hyperb1iss/droidmind droidmind --transport sse
# Server available at: sse://localhost:4256/sse

DroidMind Examples

Client configuration

Claude Desktop configuration for DroidMind using uvx in stdio transport mode.

{
  "mcpServers": {
    "droidmind": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/hyperb1iss/droidmind",
        "droidmind",
        "--transport",
        "stdio"
      ]
    }
  }
}

Prompts to try

Natural language commands that DroidMind can execute on connected Android devices.

- "List all connected Android devices and show their properties"
- "Take a screenshot of my Pixel and show it to me"
- "Show me the recent crash logs from my device"
- "Install the APK at ~/Downloads/myapp.apk on the connected device"
- "Tap the 'Next' button on the current screen"

Troubleshooting DroidMind

adb devices shows 'unauthorized' instead of 'device'

Check your Android device screen for a USB debugging authorization prompt and tap 'Allow'. If the prompt does not appear, revoke USB debugging authorizations in Developer Options and reconnect the USB cable.

uvx fails to install DroidMind with Python version error

DroidMind requires exactly Python 3.13 — Python 3.14+ is not supported. Ensure uv uses Python 3.13 by running: uvx --python 3.13 --from git+https://github.com/hyperb1iss/droidmind droidmind --transport stdio

Commands fail with 'ADB not found' error

ADB must be in your system PATH. Add the platform-tools directory to PATH in your shell profile (e.g., export PATH=$PATH:~/Library/Android/sdk/platform-tools on macOS). Restart your shell and verify with 'which adb'.

Frequently Asked Questions about DroidMind

What is DroidMind?

DroidMind is a Model Context Protocol (MCP) server that model context protocol (mcp) server that enables ai assistants to control and interact with android devices, allowing for device management, app debugging, system analysis, and ui automation through natural language commands. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install DroidMind?

Install via npm with the command: npx -y droidmind. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with DroidMind?

DroidMind works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is DroidMind free to use?

Yes, DroidMind is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "droidmind": { "command": "npx", "args": ["-y", "droidmind"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use DroidMind?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides