MCP Appium Gestures

@AppiumTestDistribution

About MCP Appium Gestures

This is a Model Context Protocol (MCP) server providing resources and tools for Appium mobile gestures using Actions API..

#mcp-appium-gestures #appium #mobile-automation

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "appium-gestures": {
      "command": "npx",
      "args": [
        "mcp-appium-gestures"
      ]
    }
  }
}

Tools

No tools detected

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 Gestures?

MCP Appium Gestures is an MCP server that provides resources and tools for common Appium mobile gestures. It offers gesture documentation and generates code for these gestures in JavaScript (WebdriverIO) and Java (Appium Java Client).

How to use MCP Appium Gestures?

Clone the repository, install dependencies with npm install, and start the server using stdio transport (npm start) or SSE transport (npm run start:sse). Configure it in your MCP settings file for Claude Desktop, Cursor, or other MCP clients, then access gesture resources via URIs like gesture://tap or use tools like generate-tap-code.

Key features of MCP Appium Gestures

Documentation resources for seven common Appium mobile gestures
Code generation tools for JavaScript (WebdriverIO) and Java
Supports tap, swipe, scroll, pinch/zoom, long press, drag and drop, and double tap
Configurable transports: stdio for local use, SSE for remote use
Parameters for element-based or coordinate-based gestures, with optional duration

Use cases of MCP Appium Gestures

Automating mobile app testing with gesture interactions
Generating code snippets for common gestures in different languages
Learning correct Appium gesture syntax via resource documentation
Integrating gesture support into AI-driven test generation workflows

FAQ from MCP Appium Gestures

What gestures does MCP Appium Gestures support?

It supports tap, swipe, scroll, pinch/zoom, long press, drag and drop, and double tap.

What languages are available for code generation?

JavaScript (WebdriverIO v9+ and below) and Java (Appium Java Client).

How do I start the server with SSE transport?

Run npm run start:sse for default port 8080, or npm run start:sse:port 3000 for a custom port.

How do I configure this server for Claude?

Add the server to your MCP settings JSON file (e.g., claude_desktop_config.json) under mcpServers with the command npx and args: ["mcp-appium-gestures"].

Can I generate code for a gesture on a specific element?

Yes. For tools like generate-tap-code and generate-long-press-code, set useElement: true and provide an elementId.

Frequently asked questions