appium_mobile_clipboard

Handle alerts with action = accept, dismiss, or gettext (optional buttonLabel)

activate

Manage contexts in one tool. action=list gets all available contexts including NATIVEAPP and WEBVIEW\ entries. action=switch switches to a target context (context required).

Opt-in (gated by APPIUMMCPDOCSENABLED). Query Appium documentation using RAG for help and guidance

Perform a drag and drop gesture from a source location to a target location (supports element-to-element, element-to-coordinates, coordinates-to-element, and coordinates-to-coordinates)

Read or update Appium driver session settings in one tool. action=get returns current settings as JSON; action=update merges a settings map (driver-specific keys; use action=get first to inspect).

Find a specific element using traditional locator strategies. Strategy priority: accessibility id > id > platform-native (-ios predicate string / -ios class chain on iOS, -android uiautomator on Android) > xpath (last resort — slow & brittle). To scroll until an element appears, use appiumgesture wi

Generate automated test code from natural language scenarios

Get, set, or reset the device GPS coordinates with action = get, set, or reset. For set, provide latitude and longitude (and optional altitude on Android). Not supported on Android emulators for reset.

Perform a touch gesture. action = back, tap, doubletap, longpress, scroll, swipe, pinchzoom, or scrolltoelement. scrolltoelement scrolls vertically (direction = up \

Get the page source (XML) from the current screen

Get text content from an element

Get the width and height of the device screen in pixels

Control device behavior: lock/unlock the screen, shake the device, or open the notifications panel (action: lock \

Get device information, battery status, or current device time. Use action = info (model, OS version, locale, timezone, screen density, etc.), battery (level as percentage and charging state), or time (current device time; accepts an optional format moment.js string, defaults to ISO 8601). Works on

Hide the on-screen keyboard or query visibility. action=hide \

Get, update, or reset app permissions in one tool (action: get / update / reset)

Get or set device/screen orientation with action = get or set (requires orientation for set).

Execute raw W3C Actions API sequences for custom multi-touch gestures (rotate, three-finger swipe, edge swipes, precise timing). Prefer appiumgesture for standard gestures.

Prepare a real iOS device for Appium testing. Two-step flow: (1) call without provisioningProfileUuid to list available .mobileprovision profiles; (2) call again with the chosen UUID and isFreeAccount to download the matching WDA release, package it as an IPA, and resign with the profile. Results ar

Start or stop screen recording with action = start or stop. On stop, returns the saved MP4 path.

Take a screenshot and save as PNG. Optionally provide elementUUID to capture a specific element. Pass returnRawBase64: true (default false) to return the raw base64 PNG inline instead of saving to disk — useful when the server runs on a remote machine where the saved file is not accessible. Intended

Unified session management. action=create: start a new session for Android, iOS, or general capabilities (see 'general' mode above); forwards capabilities to a remote server via WebDriver newSession when remoteServerUrl is provided. action=attach: connect MCP Appium to an already-running remote Appi

Enter text into an input field

Opt-in (gated by APPIUMMCPDOCSENABLED). Return ordered setup or troubleshooting skills from appium/skills for local Appium environments

Generate intelligent locators for all interactive elements on the current screen

Boot an iOS/tvOS simulator, download WDA (if not cached), and install/launch WDA in a single call. Each step is skipped if already satisfied (iOS/tvOS only). Set APPIUMMCPWDAAPPPATH to skip all downloads and use a local .app bundle instead.

REQUIRED FIRST: Discover available devices and select one. Auto-selects if only one device found