Android Tools

v1.0.0โ€ขDeveloper Toolsโ€ขstable

๐Ÿ”Œ An Android Studio plugin exposing native Gemini tools as an MCP server. Enable external AI assistants (Claude, Copilot) to call Android-specific tools directly.

android-studioclaude-codegeminigithub-copilotintellij-plugin
Share:
20
Stars
0
Downloads
0
Weekly
0/5

What is Android Tools?

Android Tools is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐Ÿ”Œ an android studio plugin exposing native gemini tools as an mcp server. enable external ai assistants (claude, copilot) to call android-specific tools directly.

๐Ÿ”Œ An Android Studio plugin exposing native Gemini tools as an MCP server. Enable external AI assistants (Claude, Copilot) to call Android-specific tools directly.

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

Features

  • ๐Ÿ”Œ An Android Studio plugin exposing native Gemini tools as a

Use Cases

Call Android-specific tools from external AI assistants.
Enable Claude and other AI models to interact with Android Studio.
amsavarthan

Maintainer

LicenseApache-2.0
Languagekotlin
Versionv1.0.0
UpdatedMay 7, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx android-tools

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 Android Tools

Android Tools MCP is an Android Studio plugin that exposes Android Studio's native Gemini-powered development tools as a standard MCP server, allowing external AI coding assistants like Claude, GitHub Copilot, and Kilo Code to call Android-specific capabilities directly. It provides 20 tools spanning device interaction (logcat, screenshots, ADB shell, UI state, Compose previews), Gradle build operations, and Android documentation search. Developers use it to give their preferred AI assistant the same Android Studio awareness that Gemini has, enabling tasks like running builds, reading device logs, and searching Android documentation without leaving the AI assistant.

Prerequisites

  • Android Studio Panda (2025.3.1) or later with the bundled Gemini plugin enabled
  • Python 3.7 or later installed on your system
  • The android-studio-mcp.py bridge script downloaded from the GitHub releases page
  • An MCP-compatible AI assistant: Claude Code, GitHub Copilot in VS Code, Kilo Code, or OpenCode
1

Install the Android Tools plugin in Android Studio

Download the latest plugin ZIP from the GitHub Releases page. In Android Studio, go to Settings โ†’ Plugins โ†’ gear icon โ†’ Install Plugin from Disk, select the ZIP file, and restart Android Studio.

2

Download the bridge script to an absolute path

Download android-studio-mcp.py from the repository to a permanent location on your machine. Note the absolute path โ€” you must use absolute paths (not ~) in all configuration because the AI assistant spawns the script directly.

# Example: save to your home directory
curl -o /Users/yourname/android-studio-mcp.py \
  https://raw.githubusercontent.com/amsavarthan/android-tools-mcp/main/android-studio-mcp.py
3

Add the MCP server to Claude Code

Use the claude mcp add command to register the bridge script. The script communicates with the Android Studio plugin over a local socket on the default port 24601.

claude mcp add android-studio -- python3 /Users/yourname/android-studio-mcp.py
4

Configure for other MCP clients (VS Code Copilot, Kilo Code, OpenCode)

For GitHub Copilot in VS Code, add the server to .vscode/mcp.json. For Kilo Code or OpenCode, add it to their respective config files. Always use absolute paths for the script location.

{
  "servers": {
    "android-studio": {
      "type": "stdio",
      "command": "python3",
      "args": ["/Users/yourname/android-studio-mcp.py"]
    }
  }
}
5

Custom port configuration (optional)

The plugin uses port 24601 by default. If another process uses that port, set a custom port in Android Studio's custom VM options (-Dmcp.bridge.port=12345) and pass the same port to the bridge script.

python3 /Users/yourname/android-studio-mcp.py --port 12345

Android Tools Examples

Client configuration

Claude Code MCP configuration for the Android Tools bridge script using an absolute path.

{
  "mcpServers": {
    "android-studio": {
      "command": "python3",
      "args": ["/Users/yourname/android-studio-mcp.py"]
    }
  }
}

Prompts to try

Example prompts using the 20 Android-specific tools exposed by the plugin.

- "Read the last 100 lines of logcat filtered to my app's package name"
- "Take a screenshot of the currently connected Android device"
- "Run a Gradle sync on this project and report any errors"
- "Search the Android documentation for 'ViewModel lifecycle'"
- "Build the debug variant of the app module"
- "Get the current UI state of the connected device"

Troubleshooting Android Tools

Connection refused when the bridge script tries to connect to Android Studio

The plugin must be installed and Android Studio must be running with a project open. The Gemini plugin must be enabled (check Settings โ†’ Plugins โ†’ search Gemini). If the port is wrong, verify it matches between Android Studio's VM options (-Dmcp.bridge.port) and the --port argument to the bridge script.

Tools stop working after an Android Studio update

This plugin uses undocumented internal APIs from Android Studio's Gemini plugin that can change without notice. Check the GitHub repository for a new plugin release compatible with your updated Android Studio version and reinstall.

python3 command not found when starting the bridge

The MCP client spawns python3 directly. Ensure Python 3.7+ is in your system PATH and accessible as 'python3'. On macOS you may need to install it via 'brew install python3'. Use the full absolute path to python3 in your config if needed (e.g., /usr/bin/python3 or /opt/homebrew/bin/python3).

Frequently Asked Questions about Android Tools

What is Android Tools?

Android Tools is a Model Context Protocol (MCP) server that ๐Ÿ”Œ an android studio plugin exposing native gemini tools as an mcp server. enable external ai assistants (claude, copilot) to call android-specific tools directly. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Android Tools?

Follow the installation instructions on the Android Tools GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Android Tools?

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

Is Android Tools free to use?

Yes, Android Tools 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": { "android-tools": { "command": "npx", "args": ["-y", "android-tools"] } } }

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

Read the full setup guide โ†’

Ready to use Android Tools?

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