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.

• 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

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

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

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

• 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

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

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

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

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

MIT