Quick Installation

Get started with MCP-Appium in seconds. Choose your preferred package manager.

Start Automating in Minutes

Install MCP-Appium and start automating mobile devices with AI-powered capabilities. Compatible with npm, yarn, and pnpm.

📦 View on NPM
$ npm install mcp-appium-visual
$ yarn add mcp-appium-visual
$ pnpm add mcp-appium-visual

See MCP-Appium in Action

Watch how AI agents control mobile devices using MCP-Appium

Powerful Features

Everything you need for modern mobile automation with AI integration

🤖

AI-Powered Automation

Advanced visual element detection and intelligent interaction using computer vision and machine learning algorithms for robust mobile automation.

📱

Cross-Platform Support

Unified automation for both Android (ADB) and iOS (Xcode) devices with consistent API and seamless platform switching.

🔗

MCP Integration

Built on Model Context Protocol for seamless integration with AI agents like Claude, enabling natural language automation.

🎯

Visual Recovery

Automatic error recovery with visual element detection when traditional locators fail, ensuring test stability and reliability.

⚡

High Performance

Optimized for speed with intelligent caching, parallel execution capabilities, and efficient resource management.

🛠️

Developer Friendly

Full TypeScript support, comprehensive documentation, extensive examples, and intuitive API design for rapid development.

Simple & Powerful API

Get started with just a few lines of code. Our intuitive API makes mobile automation accessible to developers of all skill levels.

📚 View Examples
// Initialize Appium with MCP
await initializeAppium({
platformName: 'Android',
deviceName: 'emulator-5554',
appPackage: 'com.example.app'
});
// AI-powered element interaction
await smartTap('Login Button');
// Visual element recovery
await visualElementRecovery({
screenshotPath: './screenshot.png',
elementType: 'button',
expectedText: 'Submit'
});

Documentation & Resources

Everything you need to get started and master mobile automation

📖

API Documentation

Comprehensive API reference with detailed examples and best practices.

Read Docs →
🎓

Examples

Ready-to-run examples for common automation scenarios and patterns.

Browse Examples →
🚀

Quick Start

Step-by-step guide to get up and running in minutes.

Get Started →
🔧

Configuration

Complete configuration reference for different environments.

View Configs →
🧪

Testing Guide

Comprehensive testing documentation with examples and best practices.

Testing Docs →
❓

Support

Get help, report bugs, or request features through our GitHub issues.

Get Support →

AI Agent Integration

Connect Claude or other AI assistants to mobile devices with MCP-Appium

🤖 Seamless AI Integration

Enable mobile automation for your AI assistant by adding this configuration to your Claude Desktop settings file or other MCP-compatible agents.

1

Configure MCP Server

Add the configuration to your agent's settings

2

Start Appium Server

Launch Appium on port 4723

3

Connect Device

Use Android or iOS device/emulator

4

Automate with AI

Use natural language commands

// Claude Desktop Configuration
{
"mcpServers": {
"mcp-appium-visual": {
"command": "npx",
"args": ["mcp-appium-visual@1.3.3"],
"env": {
"NODE_OPTIONS": "--max-old-space-size=4096"
}
}
}
}