MCP Appium is an Appium-organization-maintained MCP server that exposes Appium mobile automation as tools for AI assistants, covering Android and iOS across simulators, emulators, and real devices, with element finding, gestures, session management, test code generation, a plugin API, and OpenTelemetry tracing. It targets teams already using Appium for mobile testing, installs primarily over stdio via npx, and uses environment variables for capability gating. Important boundaries: it is designed as a local single-user server or a trusted CI component rather than a shared service for untrusted clients, and remote server URLs, vision model calls, and disconnect cleanup behavior all require explicit configuration.
Strongest · Documentation 14/20 Weakest · Reliability 9/20
Static review · not runListed 2026-09-18
Read the FMRS scoring method →Runtime：Node.js 22+ · Java 8+ · Prebuilt binary Android SDK (adb) fo
AI_VISION_API_KEY
API key for the vision model provider; required when AI_VISION_ENABLED=true; keep secret.
ANDROID_HOME
Path to your Android SDK installation (e.g. /Users/xyz/Library/Android/sdk); needed for Android testing.
CAPABILITIES_CONFIG
Absolute path to a capabilities. file with per-platform capability presets; optional.
SCREENSHOTS_DIR
Directory for screenshots and screen recordings; defaults to the system temp directory; optional.
NO_UI
Set to true/1 to disable HTML UI components for faster responses and fewer tokens; optional.
APPIUM_MCP_APPS_ENABLED
Set to false/0 to force the embedded UI compatibility fallback; MCP Apps static UI is enabled by default; optional.
APPIUM_MCP_ON_CLIENT_DISCONNECT
Session cleanup policy on client disconnect: delete_all (default) or skip; optional.
APPIUM_MCP_WDA_APP_PATH
Path to a local WebDriverAgentRunner-Runner.app bundle to skip GitHub downloads; optional.
REMOTE_SERVER_URL_ALLOW_REGEX
Regex restricting which remote Appium server URLs may be connected to; optional.
AI_VISION_ENABLED
Set to true to register the appium_ai vision element-finding tool; optional, off by default.
AI_VISION_API_BASE_URL
Base URL of an OpenAI-compatible vision model API; required when AI_VISION_ENABLED=true.
AI_VISION_MODEL
Vision model name; defaults to Qwen3-VL-235B-A22B-Instruct; optional.
AI_VISION_COORD_TYPE
Coordinate type: normalized (default) or absolute; optional.
AI_VISION_IMAGE_MAX_WIDTH
Max image width in pixels before compression; default 1080; optional.
AI_VISION_IMAGE_QUALITY
JPEG quality 1-100 for compressed screenshots; default 80; optional.
APPIUM_MCP_DOCS_ENABLED
Set to true to enable documentation tools; requires installing @appium/mcp-documentation separately; optional.
SENTENCE_TRANSFORMERS_MODEL
Hugging Face model for semantic doc search; default Xenova/all-MiniLM-L6-v2; optional.
APPIUM_MCP_PERSIST_REMOTE_SESSIONS_PATH
Directory path for persisting attached remote session info; optional.
APPIUM_MCP_EVIDENCE
Set to true/1 to attach structured action evidence records to tool responses for CI/debugging; optional.
APPIUM_MCP_OTEL_ENABLED
Set to true to enable OpenTelemetry tracing; disabled by default; optional.
APPIUM_MCP_OTEL_INCLUDE_ARGUMENT_VALUES
Set to true to include sanitized argument values in spans; optional.
OTEL_SERVICE_NAME
Service name reported to the OpenTelemetry collector, e.g. appium-mcp; optional.
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT
OTLP/HTTP traces endpoint, e.g. http://127.0.0.1:4318/v1/traces; optional.
OTEL_TRACES_SAMPLER
Trace sampling strategy, e.g. parentbased_always_on; optional.
OTEL_RESOURCE_ATTRIBUTES
Comma-separated key=value resource attributes attached to every span; optional.
{
"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"
}
}
}
}
Shown for Cursor. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.
{
"servers": {
"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"
}
}
}
}
Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).
claude mcp add appium-mcp -e ANDROID_HOME=/path/to/android/sdk -e CAPABILITIES_CONFIG=/path/to/your/capabilities.json -- npx appium-mcp@latest
Run it in a terminal; replace any <…> placeholders with your own values first.
The client's tool list should show select_device and appium_session_management; ask the AI to run select_device — a returned device list confirms the connection works.
Once connected, you can ask your AI assistant things like:
No matching tools
Listed from the project's documentation, not tested by this site.
MCP Appium is a Model Context Protocol server that gives AI assistants a suite of tools for mobile automation on Android (UiAutomator2) and iOS (XCUITest), covering simulators, emulators, and real devices. It supports natural-language element finding, intelligent locator generation, interactive session management, touch gestures, and automated generation of Java/TestNG test code with Page Object Model templates. It runs over stdio via npx appium-mcp@latest, bundles the UiAutomator2 and XCUITest drivers for embedded local sessions, and can also connect to a remote Appium/WebDriver server through remoteServerUrl. The project is maintained by the Appium organization under the Apache-2.0 license.
Upstash's official server providing up-to-date third-party library docs for AI coding assistants
AI-powered NPM package analysis MCP server
An independent control layer that gives AI coding agents budgets, brakes, and receipts
GitHub's official MCP server for managing repos, issues, PRs, and workflows via natural language
Source revision 460d6ebcbc06 Data synced 2026-11-02 Read the FMRS scoring method