Skip to main content
Glama
iPhone MCP Server
by Lakr233

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.

Screenshot on Cherry Studio

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

Related MCP server: iOS Device Control MCP Server

Installation

Prerequisites

  • Python 3.8 or later

  • Node.js and npm

  • iPhone with UDID

  • Xcode

Steps

  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

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      Enables AI assistants to automate mobile app testing and development for iOS and Android through natural language interactions. Supports intelligent element identification, session management, automated test generation, and comprehensive device interactions including clicks, swipes, screenshots, and app management.
      32
      10,281 npm
      521
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to control mobile and desktop devices with natural language, including running automation tasks, taking screenshots, and managing devices.
      6
      5 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to control real iPhones and simulators on macOS, allowing for UI interaction, testing, and automation.
      51 npm
      98
      MIT