MCP Appium Server
AI-powered mobile automation with Model Context Protocol (MCP) integration. Seamlessly control Android & iOS devices through Appium with intelligent visual element detection and recovery. Built for AI agents like Claude to perform complex mobile test
What is MCP Appium Server?
MCP Appium Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ai-powered mobile automation with model context protocol (mcp) integration. seamlessly control android & ios devices through appium with intelligent visual element detection and recovery. built for ai...
AI-powered mobile automation with Model Context Protocol (MCP) integration. Seamlessly control Android & iOS devices through Appium with intelligent visual element detection and recovery. Built for AI agents like Claude to perform complex mobile test
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- AI-powered mobile automation with Model Context Protocol (MC
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-appium-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Appium Server
MCP Appium Server brings AI-powered mobile test automation to Android and iOS devices by wrapping the Appium framework in a Model Context Protocol interface. It allows AI agents like Claude to tap, type, scroll, take screenshots, switch app contexts, and manage device state through natural-language instructions — replacing hand-written test scripts with conversational automation. QA engineers and mobile developers use it to perform exploratory testing, write automated regression suites, and recover from UI changes using visual element detection, all driven by an AI agent.
Prerequisites
- Node.js 14 or higher installed
- Java Development Kit (JDK) installed and JAVA_HOME set
- Android SDK installed with ANDROID_HOME set (for Android testing)
- Xcode installed on macOS (for iOS testing)
- Appium Server installed globally: npm install -g appium
Set environment variables
Configure the required environment variables for Android and/or iOS toolchains before running the server.
export JAVA_HOME=/path/to/your/java
export ANDROID_HOME=/path/to/android/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools
# macOS iOS only:
export DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer"Clone and install dependencies
Clone the repository and install Node.js packages.
git clone https://github.com/Rahulec08/appium-mcp.git
cd appium-mcp
npm installStart Appium Server
Launch the Appium server in a separate terminal. It must be running before you start the MCP server.
appiumBuild and start the MCP server
Compile the TypeScript source and start the MCP Appium server in development mode.
npm run build
npm run devConfigure Claude Desktop
Add the MCP Appium server to your Claude Desktop configuration, pointing to the compiled dist/index.js.
{
"mcpServers": {
"mcp-appium": {
"command": "node",
"args": ["/absolute/path/to/appium-mcp/dist/index.js"],
"env": {
"JAVA_HOME": "/path/to/your/java",
"ANDROID_HOME": "/path/to/android/sdk"
}
}
}
}Run tests
With Appium running and a device/emulator connected, run the bundled test suite to verify the setup.
npm testMCP Appium Server Examples
Client configuration
Claude Desktop configuration for MCP Appium Server with Java and Android SDK environment variables.
{
"mcpServers": {
"mcp-appium": {
"command": "node",
"args": ["/absolute/path/to/appium-mcp/dist/index.js"],
"env": {
"JAVA_HOME": "/usr/lib/jvm/java-17-openjdk",
"ANDROID_HOME": "/Users/yourname/Library/Android/sdk"
}
}
}
}Prompts to try
Example prompts for AI-driven mobile automation on Android and iOS devices.
- "Launch the Settings app on the connected Android emulator"
- "Take a screenshot of the current screen and describe what you see"
- "Tap the Login button and enter '[email protected]' in the email field"
- "Scroll down on the home screen until you find the Privacy settings option"
- "Run the login flow and verify the dashboard loads within 3 seconds"
- "Switch to the WebView context inside the app and interact with the embedded web page"Troubleshooting MCP Appium Server
Appium fails to find the connected device
For Android, run 'adb devices' to confirm USB debugging is enabled and the device is listed. For iOS, run 'xcrun simctl list' to verify the simulator is booted. Ensure ANDROID_HOME and JAVA_HOME are exported in the same shell where Appium runs.
npm run build fails with TypeScript compilation errors
Make sure Node.js 14+ is installed and all dependencies were installed with 'npm install'. Try deleting the node_modules directory and running 'npm install' again.
MCP server starts but Claude cannot control the device
Verify the Appium server is running (default port 4723) before starting the MCP server. Check that the device capabilities (platformName, deviceName, appPackage) are correctly set for your target device.
Frequently Asked Questions about MCP Appium Server
What is MCP Appium Server?
MCP Appium Server is a Model Context Protocol (MCP) server that ai-powered mobile automation with model context protocol (mcp) integration. seamlessly control android & ios devices through appium with intelligent visual element detection and recovery. built for ai agents like claude to perform complex mobile test It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Appium Server?
Follow the installation instructions on the MCP Appium Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Appium Server?
MCP Appium Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Appium Server free to use?
Yes, MCP Appium Server is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
MCP Appium Server Alternatives — Similar Browser Automation Servers
Looking for alternatives to MCP Appium Server? 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 Server 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 Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.