Appium MCP Server

MCP server for Mobile Development and Automation | iOS, Android, Simulator, Emulator, and Real Devices

Local serverstdioGo

What is the Appium MCP server?

Most developer tooling work still happens through a UI a human drives. Appium MCP server moves it into the conversation instead. MCP server for Mobile Development and Automation | iOS, Android, Simulator, Emulator, and Real Devices.

The short version

MCP Appium is an intelligent MCP (Model Context Protocol) server designed to empower AI assistants with a robust suite of tools for mobile automation. It streamlines mobile app testing by enabling natural language interactions, intelligent locator generation, and automated test creation for both Android and iOS platforms.

Getting it running

appium-mcp on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

The tools it exposes

The server publishes 14 tools. What each one is for:

  • Cross — Platform Support**: Automate tests for both Android (UiAutomator2) and iOS (XCUITest)
  • iOS — Requires ffmpeg to be installed and available on PATH. The default codec is libx264 with yuv420p pixel format for
  • Android — Uses the built-in screenrecord command via UiAutomator2. No additional dependencies required
  • Variable — Required
  • CAPABILITIES_CONFIG — Optional
  • SCREENSHOTS_DIR — Optional
  • NO_UI — Optional
  • APPIUM_MCP_APPS_ENABLED — Optional
  • APPIUM_MCP_ON_CLIENT_DISCONNECT — Optional
  • APPIUM_MCP_WDA_APP_PATH — Optional
  • REMOTE_SERVER_URL_ALLOW_REGEX — Optional
  • AI_VISION_ENABLED — Optional

What it needs from you

Configuration is passed through the environment: ANDROID_HOME, CAPABILITIES_CONFIG, APPIUM_MCP_WDA_APP_PATH, AI_VISION_API_BASE_URL, AI_VISION_API_KEY, APPIUM_MCP_PERSIST_REMOTE_SESSIONS_PATH. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Appium.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Appium's toolset — Cross, iOS, Android and 11 more — is a fair guide to whether it matches your workflow.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
CrossPlatform Support**: Automate tests for both Android (UiAutomator2) and iOS (XCUITest).
iOSRequires [ffmpeg](https://ffmpeg.org/download.html) to be installed and available on PATH. The default codec is libx264 with yuv420p pixel format for QuickTime compatibility.
AndroidUses the built-in screenrecord command via UiAutomator2. No additional dependencies required.
VariableRequired
CAPABILITIES_CONFIGOptional
SCREENSHOTS_DIROptional
NO_UIOptional
APPIUM_MCP_APPS_ENABLEDOptional
APPIUM_MCP_ON_CLIENT_DISCONNECTOptional
APPIUM_MCP_WDA_APP_PATHOptional
REMOTE_SERVER_URL_ALLOW_REGEXOptional
AI_VISION_ENABLEDOptional
AI_VISION_API_BASE_URLRequired when AI_VISION_ENABLED=true
AI_VISION_API_KEYRequired when AI_VISION_ENABLED=true

How to install the Appium MCP server

{
  "mcpServers": {
    "appium-mcp": {
      "disabled": false,
      "timeout": 100,
      "type": "stdio",
      "command": "npx",
      "args": ["appium-mcp@latest"],
      "env": {
        "ANDROID_HOME": "/path/to/android/sdk",
        "CAPABILITIES_CONFIG": "/path/to/your/capabilities.json"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
ANDROID_HOMEConfiguration value read at startup.Optional
CAPABILITIES_CONFIGConfiguration value read at startup.Optional
APPIUM_MCP_WDA_APP_PATHFilesystem location the server is allowed to use.Optional
AI_VISION_API_BASE_URLEndpoint or connection string the server talks to.Yes
AI_VISION_API_KEYCredential the server authenticates with.Yes
APPIUM_MCP_PERSIST_REMOTE_SESSIONS_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use Appium to Cross.
  • Use Appium to iOS.
  • Use Appium to Android.

Frequently asked questions

It connects Appium to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (Cross, iOS, Android, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Appium directly.