Iphone Mcp

Name: Iphone Mcp
Author: Lakr233

appium · by Lakr233

A Model Context Protocol (MCP) server for automating iPhone tasks with Appium. Supports app control, UI interactions, and screenshot capture via streamable HTTP.

131 1.1M/wk 9 tools GitHub npm

No known CVEs

MIT license

Stale

Last commit 307d ago

Works with most clients

Transport: http

9 tools · ~339 tok

Grade A · 0.2% of 200K ctx

Edit this pageView history

Developer Tools

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktophttp · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/iphone-mcp)](https://mcppedia.org/s/iphone-mcp)

Read me

What Iphone Mcp does

A Model Context Protocol (MCP) server for automating iPhone tasks with Appium. Supports app control, UI interactions, and screenshot capture via streamable HTTP.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'appium' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

83/100across 5 weighted dimensions

How we score →

0255075100

−17

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked appium against OSV.dev.

Inventory

Tools (9)

Click any tool to inspect its schema.

~339 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Iphone Mcp safe to use?: Iphone Mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install Iphone Mcp?: Iphone Mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Iphone Mcp do?: Iphone Mcp provides 9 tools: iphone_device_info, iphone_device_apps, iphone_interface_snapshot, iphone_interface_elements, iphone_operate_click and 4 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Iphone Mcp?: Iphone Mcp is compatible with claude-desktop, cursor, claude-code. It uses http transport.
Is Iphone Mcp actively maintained?: Iphone Mcp is less actively maintained — last commit was 307 days ago. It has 131 GitHub stars.

Similar servers

Others in developer-tools

View all →

XcodeBuildMCP97

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0k 2

Jscpd97

Copy/paste detector for programming source code, supports 223 formats. AI-ready with token-efficient reporter, skill and MCP server.

5.8k 1

XcodeBuildMCP97

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

6.0k 1

Supabase MCP Server96

Manage Supabase projects — databases, auth, storage, and edge functions

2.8k 4

MCP Security Weekly

Get CVE alerts and security updates for Iphone Mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Installation

Prerequisites

Python 3.8 or later

Node.js and npm

iPhone with UDID

Xcode

Steps

Clone the repo: git clone https://github.com/Lakr233/iphone-mcp.git && cd iphone-mcp

Set up virtual environment: python -m venv .venv && source .venv/bin/activate

Install dependencies: pip install -r requirements.txt

Install Appium: npm install -g appium && appium driver install xcuitest

Set up WebDriver Agent: Follow the WebDriver Agent Guide

Configure: Edit start.sh with your DEVICE_UDID

Tools

iphone_device_info: Get device details

iphone_device_apps: List installed apps

iphone_interface_snapshot: Capture screenshot and XML

iphone_interface_elements: List UI elements

iphone_operate_click: Perform tap

iphone_operate_swipe: Perform swipe

iphone_operate_text_input: Input text

iphone_operate_app_launch: Launch app

iphone_operate_get_current_bundle_id: Get current bundle ID

Frequently Asked Questions

Is Iphone Mcp safe to use?

Iphone Mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.

How do I install Iphone Mcp?

Iphone Mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Iphone Mcp do?

Iphone Mcp provides 9 tools: iphone_device_info, iphone_device_apps, iphone_interface_snapshot, iphone_interface_elements, iphone_operate_click and 4 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Iphone Mcp?

Iphone Mcp is compatible with claude-desktop, cursor, claude-code. It uses http transport.

Is Iphone Mcp actively maintained?

Iphone Mcp is less actively maintained — last commit was 307 days ago. It has 131 GitHub stars.

iPhone MCP Server

A Model Context Protocol (MCP) server for automating iPhone tasks with Appium. Supports app control, UI interactions, and screenshot capture via streamable HTTP.

We recommend Cherry Studio as an MCP client for iPhone automation.

Features

Retrieve device info and list installed apps
Capture screenshots (JPEG, around 500KB)
List UI elements and perform touch operations
Launch or switch apps using bundle IDs
Optimized XML output to minimize token usage

Installation

Prerequisites

Python 3.8 or later
Node.js and npm
iPhone with UDID
Xcode

Steps

Clone the repo: git clone https://github.com/Lakr233/iphone-mcp.git && cd iphone-mcp
Set up virtual environment: python -m venv .venv && source .venv/bin/activate
Install dependencies: pip install -r requirements.txt
Install Appium: npm install -g appium && appium driver install xcuitest
Set up WebDriver Agent: Follow the WebDriver Agent Guide
Configure: Edit start.sh with your DEVICE_UDID

Usage

Run ./start.sh to start Appium and the MCP server. Access it at http://127.0.0.1:8765/mcp with default settings.

Tools

iphone_device_info: Get device details
iphone_device_apps: List installed apps
iphone_interface_snapshot: Capture screenshot and XML
iphone_interface_elements: List UI elements
iphone_operate_click: Perform tap
iphone_operate_swipe: Perform swipe
iphone_operate_text_input: Input text
iphone_operate_app_launch: Launch app
iphone_operate_get_current_bundle_id: Get current bundle ID

Configuration

Set environment variables in start.sh (defaults in src/utils.py):

DEVICE_UDID (required)
APPIUM_HOST/PORT
SERVER_HOST/PORT/PATH
LOG_LEVEL

Development

Run tests: pytest
Code style: Python 3.8+ with type hints

Contributing

Fork the repo, create a branch, and submit a pull request. Report bugs or suggest features via issues.

License

MIT