What are the prerequisites to use this server?
Node.js v14+, JDK, Android SDK (for Android), Xcode (for iOS, macOS only), Appium Server installed globally, and a connected Android device/emulator or iOS device/simulator.
MCP Appium Server
@Rsec08
Basic information
About MCP Appium Server
MCP SERVER for appium
MCP Appium Server config
No standard config provided
This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.
RepositoryMCP Appium Server tools
Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is MCP Appium Server?
An MCP server implementation for mobile app automation using Appium. It provides a Model Context Protocol interface to control mobile devices (Android and iOS) through Appium, enabling automated testing and interaction with native apps.
How to use MCP Appium Server?
Install dependencies (npm install), start Appium server (appium), build the project (npm run build), then start the MCP server (npm run dev). Run tests with npm test. Configure device name, app path, or app package/activity in examples/appium-test.ts.
Key features of MCP Appium Server
- Find and interact with mobile UI elements (tap, type, scroll)
- Launch, close, reset apps; get current package/activity
- Control device orientation, keyboard, lock/unlock, take screenshots
- Switch between native and WebView contexts
- Perform file operations and custom gestures
- Retrieve battery info and device notifications
Use cases of MCP Appium Server
- Automate testing of Android and iOS mobile applications
- Perform UI regression testing with element locators and gestures
- Validate app behavior across different device orientations and states
- Manage app lifecycle and capture screenshots for reporting
- Interact with hybrid apps by switching between native and WebView contexts
Frequently asked questions
How do I configure the server for my own app instead of the Settings demo?
Edit `examples/appium-test.ts`: update `deviceName`, set `app` path to your APK, or specify `appPackage` and `appActivity` for an installed app. Common capabilities include `platformName`, `automationName`, and `noReset`.
What if my device is not found?
Run `adb devices` to confirm the device is connected. Ensure USB debugging is enabled. Try reconnecting the device or restarting the adb server.
Why can't Appium find elements in my app?
Use Appium Inspector to verify your selectors. Check that elements are visible on screen (not off-screen or covered). Try different locator strategies (e.g., XPath, accessibility id).
What causes connection issues with the MCP server?
Verify Appium server is running on the default port, check for port conflicts, and ensure the capabilities (deviceName, platformName) are correctly set in your test configuration.
More Other MCP servers
Maestro
mobile-dev-incPainless E2E Automation for Mobile and Web
14.8K
ICSS
chokcoco不止于 CSS
20.7K
Lemon.io
lemon-ioRequest dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3
Handl
Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.
Yuppsy
Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code
Comments