MCP Appium
Enables AI assistants to automate mobile app testing and development for iOS and Android through natural language interactions. Supports intelligent element identification, session management, automated test generation, and comprehensive device inter
What is MCP Appium?
MCP Appium is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai assistants to automate mobile app testing and development for ios and android through natural language interactions. supports intelligent element identification, session management, automat...
Enables AI assistants to automate mobile app testing and development for iOS and Android through natural language interactions. Supports intelligent element identification, session management, automated test generation, and comprehensive device inter
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables AI assistants to automate mobile app testing and dev
Use Cases
Maintainer
Works with
Installation
NPM
npx -y appium-mcpManual Installation
npx -y appium-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Appium
MCP Appium is an MCP server that enables AI assistants to automate iOS and Android mobile app testing and interaction through natural language. It connects to Appium — the open-source mobile automation framework — and exposes tools for session management, element discovery, gestures, screenshot capture, screen recording, and automated test code generation. Developers and QA engineers use it to describe test scenarios in plain English and have the AI generate, run, and debug mobile test suites without writing Appium code manually.
Prerequisites
- Node.js 18+ and npm installed
- Appium 2.x installed and running (npm install -g appium)
- Android SDK with ANDROID_HOME set (for Android testing), or Xcode with a simulator/real device configured (for iOS testing)
- A device capabilities JSON file describing your target device
- An MCP-compatible client such as Claude Desktop, Cursor, or Claude Code
Install Appium and device drivers
Install Appium globally and the appropriate drivers for your target platforms. The UiAutomator2 driver covers Android; the XCUITest driver covers iOS.
npm install -g appium
appium driver install uiautomator2
appium driver install xcuitestCreate a capabilities configuration file
Create a JSON file defining device capabilities such as platform name, device name, and app path. This file is referenced by the CAPABILITIES_CONFIG environment variable so the MCP server knows which device to target.
{
"platformName": "Android",
"deviceName": "emulator-5554",
"app": "/path/to/your/app.apk",
"automationName": "UiAutomator2"
}Start the Appium server
Launch the Appium server before connecting your MCP client. By default it listens on port 4723.
appium server --port 4723Configure your MCP client
Add the appium-mcp server to your MCP client configuration. Set ANDROID_HOME and CAPABILITIES_CONFIG to match your local setup. Use NO_UI=true for faster, lighter responses when you do not need the UI components.
{
"mcpServers": {
"appium-mcp": {
"command": "npx",
"args": ["appium-mcp@latest"],
"env": {
"ANDROID_HOME": "/path/to/android/sdk",
"CAPABILITIES_CONFIG": "/path/to/capabilities.json",
"SCREENSHOTS_DIR": "/tmp/appium-screenshots",
"NO_UI": "true"
}
}
}
}Restart your MCP client and verify
Restart Claude Desktop or your MCP client after saving the configuration. Ask it to list connected devices or take a screenshot to confirm the Appium MCP connection is active.
MCP Appium Examples
Client configuration
Full claude_desktop_config.json entry for appium-mcp with Android SDK path and capabilities file.
{
"mcpServers": {
"appium-mcp": {
"disabled": false,
"timeout": 100,
"type": "stdio",
"command": "npx",
"args": ["appium-mcp@latest"],
"env": {
"ANDROID_HOME": "/Users/yourname/Library/Android/sdk",
"CAPABILITIES_CONFIG": "/Users/yourname/.appium/capabilities.json",
"SCREENSHOTS_DIR": "/tmp/appium-screenshots",
"NO_UI": "true"
}
}
}
}Prompts to try
Natural language test automation prompts you can give your AI assistant once appium-mcp is connected.
- "Open the Amazon app, search for 'iPhone 15 Pro', tap the first result, and add it to the cart"
- "Take a screenshot of the current screen and describe what you see"
- "Find the login button on screen and tap it, then enter username '[email protected]' and password 'pass123'"
- "Generate a Java TestNG test suite for the checkout flow I just walked through"
- "Swipe left three times on the onboarding carousel and then tap 'Get Started'"Troubleshooting MCP Appium
Appium session fails to start with 'Could not find a connected Android device'
Verify ANDROID_HOME is set correctly and points to your Android SDK. Run 'adb devices' to confirm your emulator or physical device is listed. Make sure the Appium server is running on port 4723 before attempting a session.
iOS simulator not found or WebDriverAgent fails to install
Run 'appium driver install xcuitest' if not done yet. For simulators, use 'xcrun simctl list' to get the correct device name. For real devices, ensure the device is trusted and provisioning profiles are set up via Xcode.
Elements not found during automation
Enable AI_VISION_ENABLED=true with a valid AI_VISION_API_KEY and AI_VISION_API_BASE_URL to use vision-based element finding as a fallback. Alternatively, ask the AI to call appium_get_page_source to inspect the UI hierarchy and identify correct locator strategies.
Frequently Asked Questions about MCP Appium
What is MCP Appium?
MCP Appium is a Model Context Protocol (MCP) server that enables ai assistants to automate mobile app testing and development for ios and android through natural language interactions. supports intelligent element identification, session management, automated test generation, and comprehensive device inter It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Appium?
Install via npm with the command: npx -y appium-mcp. 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 MCP Appium?
MCP Appium works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Appium free to use?
Yes, MCP Appium is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
MCP Appium Alternatives — Similar Browser Automation Servers
Looking for alternatives to MCP Appium? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Appium in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Appium?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.