Skip to main content
Glama
Android Screenshot MCP Server

Android Screenshot MCP Server

by adamlj

Android Screenshot MCP Server

MCP server for taking screenshots of Android devices over WiFi. Useful for UI debugging and visual inspection during development.

Features

  • Wireless screenshot capture via ADB

  • Automatic device detection and connection

  • Smart pairing for first-time setup

  • UI/UX debugging and layout inspection

Related MCP server: Android MCP Server

Setup

  1. Install dependencies:

    npm install
  2. Add to Claude Code:

    claude mcp add android /path/to/android-screenshot-mcp/src/index.js
  3. Enable wireless debugging on your Android device:

    • Settings → Developer Options → Wireless Debugging

    • Note the IP address and ports shown

Usage

The tool automatically detects connected devices. If no device is connected, it will guide you through the setup.

Quick Usage

For already connected devices:

screenshot phone

For new connections, provide the IP and port shown in your device's wireless debugging settings:

screenshot phone with 192.168.1.100:41737

First-time Setup

If this is your first time connecting, you'll need to pair first:

screenshot phone with 192.168.1.100:41737 and pairing code 123456 port 54321

The tool accepts several formats:

  • deviceIP: "192.168.1.100:41737" - IP with port included

  • deviceIP: "192.168.1.100", debugPort: 41737 - Separate parameters

  • Natural language like "192.168.1.100:41737 and pairing: 123456 port 54321"

Requirements

  • Android 11+ device with wireless debugging

  • ADB installed on your computer

  • Same WiFi network for both devices

Troubleshooting

"Maximum call stack size exceeded" Error

This error has been fixed in the latest version. If you still encounter it, ensure you're running the latest code.

Connection Issues

  • Verify wireless debugging is enabled on your device

  • Check that the IP address and port match what's shown on your device

  • Make sure both devices are on the same WiFi network

  • Try disabling and re-enabling wireless debugging

  • Note: The wireless debugging port changes when you toggle it off/on

Pairing Issues

  • Pairing codes expire quickly (usually within 2 minutes)

  • Generate a fresh pairing code right before using it

  • The pairing port is different from the wireless debugging port

  • Once paired, you shouldn't need to pair again unless you reset connections

How it Works

The tool uses wireless ADB connections and remembers your last successful connection for convenience. Each screenshot session will:

  1. Check for already connected devices first

  2. If none found, try to reconnect to the last used device automatically

  3. If that fails, prompt for connection details

  4. Successfully connected devices are saved to ~/.android-screenshot-mcp/config.json

This means after your first successful connection, the tool can often reconnect automatically without needing the IP and port again.

Available Tools

2 tools
connect_and_screenshotA

Connect to an Android device and take a screenshot. Use when no device is connected.

Inputs: deviceIP (required), debugPort, pairingPort, pairingCode, +1 more.

screenshotA

Take a screenshot of any connected Android device. Uses existing ADB connections or connects wirelessly if device info provided.

Inputs: deviceIP, debugPort, pairingPort, pairingCode, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 2 tools

    Disambiguation2/5

    The two tools have overlapping purposes with unclear boundaries. Both are focused on taking Android screenshots, with 'connect_and_screenshot' implying connection and capture, while 'screenshot' can also handle connections if needed. This creates ambiguity about when to use each tool, as their descriptions suggest similar functionality with minor variations in connection handling.

    Naming Consistency4/5

    The tool names follow a consistent snake_case pattern and use clear verbs ('connect_and_screenshot', 'screenshot'). While the naming is technically consistent, the inclusion of 'connect_and_' in one name versus not in the other creates a minor deviation in structure, but overall the naming is readable and follows a predictable style.

    Tool Count3/5

    With only 2 tools, the server feels thin for its purpose of Android screenshot management. While it covers basic screenshot functionality, the limited tool count may restrict more advanced operations or device management tasks, placing it in the borderline range where the scope seems underdeveloped.

    Completeness2/5

    The tool set is significantly incomplete for Android device interaction. It only provides screenshot capabilities without covering essential operations like listing devices, managing connections, handling multiple devices, or performing other common ADB commands. This creates gaps that could lead to agent failures when broader device control is needed.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI agents to capture screenshots from Android devices and emulators, and manage connected devices for UI analysis and testing. Supports device listing, screenshot capture, and integrates with Claude Desktop, Gemini CLI, and GitHub Copilot.
      2
      9 npm
      26
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables control of Android devices through ADB, allowing users to list connected devices, capture screenshots using multiple methods (adb, droidcast, minicap, mumu), and retrieve device information.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables a local coding agent to control and inspect an Android phone over the user's own Wi-Fi, with on-device consent and an app blocklist. Provides tools to read the screen, take screenshots, tap, swipe, type, scroll, and navigate Back, Home, or Recents.
      MIT