All servers / Developer / Appium MCP server
Appium MCP server
Intelligent MCP server providing AI assistants with powerful tools and resources for Appium mobile automation
Tested by ConnectATDScore 93 out of 100. Tested 2026-11-18 on package version 1.99.3. Package: appium-mcp · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 19 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 16 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (38.1 seconds including download)
- Tools offered: 32
- Last published: 2026-11-04
- Weekly downloads (npm): 10,220
- License: Apache-2.0 · Direct dependencies: 17
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
select_device3 of 3 parameters describedDiscover/select a LOCAL device. Ask for platform if unknown; one device is auto-selected. For multiple devices, ask the user to choose, then pass deviceUdid. Next: prepare_ios_simulator for iOS simulators, then appium_session_management action=create. Skip for REMOTE servers: pass device capabilities (appium:deviceName/appium:udid) and the user-provided remoteServerUrl to session creation.
appium_session_management5 of 5 parameters describedManage Appium sessions. Use action=create to start a session, attach to connect to an existing one, detach to forget an attached session, delete to stop one, list to see all active sessions, or select to switch the active session.
appium_mobile_device_control3 of 3 parameters describedControl device behavior: lock/unlock the screen, shake the device, or open the notifications panel. Use the action parameter to choose what to do.
appium_geolocation5 of 5 parameters describedGet, set, or reset the device geolocation (GPS coordinates). Works on both iOS (simulators and real devices) and Android (emulators and real devices with mock location enabled). Use action=get to read current coordinates, action=set with latitude/longitude (and optional altitude for Android) to simulate a location, or action=reset to restore the system default. Note: On Android emulators, reset is not supported — use action=set to manually restore coordinates instead. On Android real devices, the mocked location may persist until the GPS cache refreshes.
appium_mobile_device_info3 of 3 parameters describedGet device information, battery status, or current device time in a single call. Use the "action" parameter to select which data to retrieve. Works on both iOS and Android.
appium_mobile_file4 of 4 parameters describedPush or pull a file using Appium mobile extensions. action=push uses payloadBase64, action=pull returns contentBase64.
appium_driver_settings3 of 3 parameters describedRead or update Appium driver session settings (e.g. idle timeouts, selector waits). Use action=get to return JSON settings; action=update merges a map into the session. Works for embedded UiAutomator2/XCUITest sessions and remote WebDriver clients that support Appium settings.
prepare_ios_simulator4 of 4 parameters describedBoot an iOS/tvOS simulator, download/cache WDA, and launch it on a free per-simulator port. Pass capabilitiesHint (appium:webDriverAgentUrl) to appium_session_management action=create to reuse WDA. skipWda=true only boots. APPIUM_MCP_WDA_APP_PATH can point to an extracted WebDriverAgentRunner-Runner.app (absolute path) to skip download.
appium_prepare_ios_real_device3 of 3 parameters describedPrepare signed WDA for a real iOS device. Omit provisioningProfileUuid to list profiles; ask the user to choose, highlighting recommendedForWda. Pass the chosen UUID to download, package, and sign WDA; wildcard profiles use a concrete WDA bundle ID. Downloads/unsigned IPA are cached per version; signing always reruns. Pass capabilitiesHint to appium_session_management action=create to install/launch the signed WDA. Requires macOS, Xcode 16+, and a paired developer-mode device.
appium_gesture17 of 17 parameters describedPerform a touch gesture. Use 'action' to choose: tap, double_tap, long_press, scroll, swipe, pinch_zoom, scroll_to_element, back. Choose scroll vs swipe by intent: scroll to browse content in a list or feed; swipe to dismiss, switch screens, navigate carousels, or pull-to-refresh (speed=fast). For drag-and-drop use appium_drag_and_drop. For custom multi-touch use appium_perform_actions.
appium_drag_and_drop9 of 9 parameters describedPerform a drag-and-drop gesture from a source location to a target location. The gesture: long press the source (default 600ms), drag to the target (default 1200ms), then release. Source and target can each be specified as either an element UUID or coordinates. Useful for reordering lists, moving items, drag-to-delete.
appium_perform_actions2 of 2 parameters describedExecute raw W3C Actions API sequences for advanced multi-touch gestures not covered by appium_gesture. Use this for custom multi-finger gestures (rotate, three-finger swipe, edge swipes), complex timing sequences, or any gesture requiring precise control over individual touch points. Prefer appium_gesture for standard gestures (tap, scroll, swipe, pinch) — it handles platform differences automatically.
appium_find_element3 of 3 parameters describedFind an element by strategy and selector. Pass its ID as elementUUID to interaction tools. Returns driver attributes as JSON. For drivers supporting elementResponseAttributes, use appium_driver_settings to configure it with shouldUseCompactResponses=false. Prefer accessibility id > id > platform-native > xpath (last resort: slow/brittle). See strategy for platform-specific guidance. To scroll until a target is found, use appium_gesture action=scroll_to_element with the same strategy and selector, rather than repeatedly calling this tool. Vision fallback: appium_ai action=find_element (if enabled).
appium_find_elements3 of 3 parameters describedFind all elements matching a strategy and selector. Returns JSON {elements: [{elementId, attributes?}]}; no matches returns {elements: []}. Pass an elementId as elementUUID to interaction tools. Additional driver attributes are preserved. For drivers supporting elementResponseAttributes, use appium_driver_settings to configure it with shouldUseCompactResponses=false. Use appium_find_element when only one match is needed.
appium_mobile_press_key4 of 4 parameters describedPress navigation keys (BACK, HOME, APP_SWITCH) on Android or physical buttons (HOME, volume, etc.) on iOS/tvOS.
appium_set_value4 of 4 parameters describedEnter text into an element
appium_mobile_keyboard3 of 3 parameters describedHide the software keyboard or check if it is visible (Android UiAutomator2 / iOS XCUITest). action=hide uses mobile: hideKeyboard; action=is_shown uses mobile: isKeyboardShown.
appium_get_text2 of 2 parameters describedGet text from an element
appium_get_element_attribute3 of 3 parameters describedGet the value of an element attribute. Use this to check element state (enabled, selected, checked, focused, displayed, clickable) or read properties (name, value, label, content-desc, resource-id, class).
appium_mobile_clipboard3 of 3 parameters describedRead or set the device clipboard as plain text (Android UiAutomator2 / iOS XCUITest). action=get returns current text; action=set requires content.
appium_get_active_element1 of 1 parameter describedGet the currently active/focused element and return its UUID for follow-up interactions. [PRIORITY 1: Use this first when you need to find what element currently has focus]
appium_get_page_source4 of 4 parameters describedGet current-screen XML. saveToFile=true returns server-local path/bytes and enables selector/pattern summaries.
appium_orientation3 of 3 parameters describedGet or set the device/screen orientation. Supports action=get and action=set (LANDSCAPE or PORTRAIT).
appium_alert3 of 3 parameters describedHandle system alerts with action=accept|dismiss, or read alert text with action=get_text.
appium_screenshot4 of 4 parameters describedTake a screenshot and save as PNG. Optionally provide elementUUID to capture only that element.
appium_get_window_size1 of 1 parameter describedGet the width and height of the device screen in pixels. Useful for calculating coordinates for swipes, taps, and scrolls.
appium_screen_recording13 of 13 parameters describedStart or stop screen recording. action=start begins recording; action=stop stops and saves to MP4.
appium_app_lifecycle10 of 10 parameters describedManage app lifecycle, installation, state, data, and deep links.
appium_mobile_permissions10 of 10 parameters describedGet/update Android app permissions or iOS Simulator privacy services; reset iOS privacy prompts. See action-specific parameters.
appium_context3 of 3 parameters describedManage Appium contexts with one tool. action=list returns all contexts and current context. action=switch changes to a target context.
generate_locators3 of 3 parameters describedGenerate current-page locator candidates for inspection. Defaults: controls for UiAutomator2/XCUITest/Web; all elements except hierarchy for other native drivers.
appium_generate_tests1 of 1 parameter describedReturn a workflow to execute the scenario with MCP tools, then generate test code from observed interactions. Prefer appium_find_element; generate_locators is for broad inspection.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.