# Mcp Appium Gestures

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-appiumtestdistribution-mcp-appium-gestures`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [AppiumTestDistribution](https://agentstack.voostack.com/s/appiumtestdistribution)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [AppiumTestDistribution](https://github.com/AppiumTestDistribution)
- **Source:** https://github.com/AppiumTestDistribution/mcp-appium-gestures

## Install

```sh
agentstack add mcp-appiumtestdistribution-mcp-appium-gestures
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

[](https://mseep.ai/app/appiumtestdistribution-mcp-appium-gestures)

# MCP Appium Gestures

An MCP (Model Context Protocol) server providing resources and tools for Appium mobile gestures.

## Features

- Documentation resources for common Appium mobile gestures:

  - Tap
  - Swipe
  - Scroll
  - Pinch/Zoom
  - Long Press
  - Drag and Drop
  - Double Tap

- Tools to generate code for these gestures in different languages:
  - JavaScript (WebdriverIO v9+ and below)
  - Java (Appium Java Client)

## Installation

```bash
# Clone the repository
git clone https://github.com/yourusername/mcp-appium-gestures.git
cd mcp-appium-gestures

# Install dependencies
npm install
```

## Usage

### Start with stdio transport (for local use)

```bash
# Start the server with stdio transport
npm start
# or
npm run start:stdio
```

### Start with SSE transport (for remote use)

```bash
# Start the server with SSE transport on default port (8080)
npm run start:sse

# Start the server with SSE transport on a custom port
npm run start:sse:port 3000
```

### Development and Testing

```bash
# Test with mcp-cli
npm run dev

# Inspect with MCP Inspector
npm run inspect
```

## Usage with Claude

To use this MCP server with Claude, you need to add it to your MCP settings configuration file. The location of this file depends on your platform:

- For Cursor: `/Users/[username]/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
- For Claude Desktop: `/Users/[username]/Library/Application Support/Claude/claude_desktop_config.json`
- For Cline or other MCP clients: Check your client's documentation for the configuration file location

Add the following configuration to the `mcpServers` object in the settings file:

```json
{
  "mcpServers": {
    "appium-gestures": {
      "command": "npx",
      "disabled": false,
      "args": ["mcp-appium-gestures"],
      "autoApprove": [],
      "timeout": 300,
      "transportType": "stdio"
    }
  }
}
```

Once configured, you can use the MCP server's tools and resources directly in Claude:

```

appium-gestures
generate-tap-code

{
  "language": "javascript",
  "useElement": true,
  "elementId": "login-button"
}

```

Or access resources:

```

appium-gestures
gesture://tap

```

## Resources

The server provides documentation resources for the following gestures:

- `gesture://tap` - Tap gesture documentation
- `gesture://swipe` - Swipe gesture documentation
- `gesture://scroll` - Scroll gesture documentation
- `gesture://pinch-zoom` - Pinch and zoom gestures documentation
- `gesture://long-press` - Long press gesture documentation
- `gesture://drag-drop` - Drag and drop gesture documentation
- `gesture://double-tap` - Double tap gesture documentation

You can also access a specific gesture by name using the template: `gesture://{name}`

## Tools

The server provides the following tools to generate code for Appium gestures:

### generate-tap-code

Generates code for tap gesture.

Parameters:

- `language`: 'javascript' or 'java'
- `useElement`: boolean - whether to tap on an element or at coordinates
- `elementId`: string (required if useElement is true) - the element ID to tap on
- `x`: number (required if useElement is false) - x coordinate to tap at
- `y`: number (required if useElement is false) - y coordinate to tap at

### generate-swipe-code

Generates code for swipe gesture.

Parameters:

- `language`: 'javascript' or 'java'
- `startX`: number - starting x coordinate
- `startY`: number - starting y coordinate
- `endX`: number - ending x coordinate
- `endY`: number - ending y coordinate
- `duration`: number (optional, default: 500) - duration of the swipe in milliseconds

### generate-scroll-code

Generates code for scroll gesture.

Parameters:

- `language`: 'javascript' or 'java'
- `direction`: 'up', 'down', 'left', or 'right'
- `useElement`: boolean (optional, default: false) - whether to scroll to an element
- `elementId`: string (optional) - the element ID to scroll to
- `distance`: number (optional, default: 300) - distance to scroll

### generate-long-press-code

Generates code for long press gesture.

Parameters:

- `language`: 'javascript' or 'java'
- `useElement`: boolean - whether to long press on an element or at coordinates
- `elementId`: string (required if useElement is true) - the element ID to long press on
- `x`: number (required if useElement is false) - x coordinate to long press at
- `y`: number (required if useElement is false) - y coordinate to long press at
- `duration`: number (optional, default: 2000) - duration of the long press in milliseconds

### generate-double-tap-code

Generates code for double tap gesture.

Parameters:

- `language`: 'javascript' or 'java'
- `useElement`: boolean - whether to double tap on an element or at coordinates
- `elementId`: string (required if useElement is true) - the element ID to double tap on
- `x`: number (required if useElement is false) - x coordinate to double tap at
- `y`: number (required if useElement is false) - y coordinate to double tap at
- `pauseDuration`: number (optional, default: 200) - pause duration between taps in milliseconds

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [AppiumTestDistribution](https://github.com/AppiumTestDistribution)
- **Source:** [AppiumTestDistribution/mcp-appium-gestures](https://github.com/AppiumTestDistribution/mcp-appium-gestures)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-appiumtestdistribution-mcp-appium-gestures
- Seller: https://agentstack.voostack.com/s/appiumtestdistribution
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.