appium-mcp
Intelligent MCP server providing AI assistants with powerful tools and resources for Appium mobile automation
Versions
1.90.1latest1.90.01.89.01.88.51.88.4+ show 239 moreshow less
1.88.31.88.21.88.11.88.01.87.101.87.91.87.81.87.71.87.61.87.51.87.41.87.31.87.21.87.11.87.01.86.131.86.121.86.111.86.101.86.91.86.81.86.71.86.61.86.51.86.41.86.31.86.21.86.11.86.01.85.101.85.91.85.81.85.71.85.61.85.51.85.41.85.31.85.21.85.11.85.01.84.21.84.11.84.01.83.01.82.21.82.11.82.01.81.71.81.61.81.51.81.41.81.31.81.21.81.11.81.01.80.01.79.11.79.01.78.11.78.01.77.01.76.01.75.71.75.51.75.41.75.31.75.21.75.11.75.01.74.31.74.21.74.11.74.01.73.01.72.161.72.151.72.141.72.131.72.121.72.111.72.101.72.91.72.81.72.71.72.61.72.51.72.41.72.31.72.21.72.11.72.01.71.61.71.51.71.41.71.31.71.21.71.11.71.01.70.01.69.11.69.01.68.01.67.11.67.01.66.01.65.01.64.01.63.11.63.01.62.01.61.01.60.21.60.11.60.01.59.11.59.01.58.01.57.01.56.31.56.21.56.11.56.01.55.01.54.01.53.11.53.01.52.01.51.01.50.01.49.11.49.01.48.01.47.01.46.01.45.01.44.11.44.01.43.01.42.01.41.01.40.01.39.01.38.21.38.11.38.01.37.01.36.01.35.01.34.41.34.31.34.21.34.11.34.01.33.01.32.01.31.01.30.01.29.01.28.01.27.11.27.01.26.01.25.01.24.21.24.11.24.01.23.11.23.01.22.01.21.21.21.11.21.01.20.01.19.11.19.01.18.11.18.01.17.01.16.11.16.01.15.11.15.01.14.01.13.01.12.41.12.31.12.21.12.11.12.01.11.11.11.01.10.01.9.31.9.21.9.11.9.01.8.161.8.151.8.141.8.131.8.121.8.111.8.101.8.91.8.81.8.71.8.61.8.51.8.41.8.31.8.21.8.11.8.01.7.51.7.41.7.31.7.21.7.11.7.01.6.11.6.01.5.01.4.01.3.01.2.01.1.171.1.161.1.151.1.141.1.131.1.121.1.111.1.101.1.91.1.81.1.61.1.51.1.40.0.1Tools 47
appium_geolocation Get, 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_info Get 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_device_control Control device behavior: lock/unlock the screen, shake the device, or open the notifications panel. Use the action parameter to choose what to do.
appium_mobile_file Push or pull a file using Appium mobile extensions. action=push uses payloadBase64, action=pull returns contentBase64.
appium_driver_settings Read or update Appium driver session settings (e.g. idle timeouts, selector waits).
select_device Discover/select a LOCAL device. Ask for platform if unknown; one device is auto-selected.
appium_mobile_permissions Get/update Android app permissions or iOS Simulator privacy services; reset iOS privacy prompts. See action-specific parameters.
appium_app_lifecycle Manage app lifecycle, installation, state, data, and deep links.
appium_ai Vision-based AI capabilities (FALLBACK - use only when traditional tools cannot locate the element).
appium_mobile_clipboard Read or set the device clipboard as plain text (Android UiAutomator2 / iOS XCUITest).
appium_screen_recording Start or stop screen recording. action=start begins recording; action=stop stops and saves to MP4.
appium_alert Handle system alerts with action=accept|dismiss, or read alert text with action=get_text.
appium_screenshot Take a screenshot and save as PNG. Optionally provide elementUUID to capture only that element.
appium_get_window_size Get the width and height of the device screen in pixels. Useful for calculating coordinates for swipes, taps, and scrolls.
appium_find_element appium_get_active_element Get 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_mobile_press_key Press navigation keys (BACK, HOME, APP_SWITCH) on Android or physical buttons (HOME, volume, etc.) on iOS/tvOS.
appium_get_element_attribute Get 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_get_page_source Get the page source (XML) from the current screen
appium_get_text Get text from an element
appium_set_value Enter text into an element
appium_mobile_keyboard Hide the software keyboard or check if it is visible (Android UiAutomator2 / iOS XCUITest).
appium_orientation Get or set the device/screen orientation. Supports action=get and action=set (LANDSCAPE or PORTRAIT).
appium_context Manage Appium contexts with one tool. action=list returns all contexts and current context. action=switch changes to a target context.
appium_perform_actions Execute raw W3C Actions API sequences for advanced multi-touch gestures not covered by appium_gesture.
appium_drag_and_drop Perform a drag-and-drop gesture from a source location to a target location.
appium_gesture Perform a touch gesture. Use 'action' to choose: ${GESTURE_ACTIONS.join(', ')}.
appium_prepare_ios_real_device Prepare signed WDA for a real iOS device. Omit provisioningProfileUuid to list profiles;
prepare_ios_simulator Boot an iOS/tvOS simulator, download/cache WDA, and launch it on a free per-simulator port.
appium_generate_tests Return 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.
generate_locators Generate locators for all interactable elements on the current page. [PRIORITY 3: Use this for debugging/inspection or when you need comprehensive element info with locator suggestions]
plugin_tool my_tool A test tool
same_tool first tool
target_tool test
screenshot test
tool_to_modify test
tool_to_pass_through test
custom_tool A custom tool
repeat_tool A repeat tool
builtin_tool plugin tool
another_builtin_tool plugin tool
working_plugin_tool working tool
blocked_tool Blocked test tool
plugin_allowed Allowed plugin tool
plugin_blocked Blocked plugin tool
appium_session_management Manage 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.
Permissions 4
network medium filesystem low shell high env_vars low