witchan/ios-mcp

iOS MCP: MCP management tool for jailbroken iPhones, enabling developers and AI agents to inspect and control devices.

What it solves

iOS MCP allows AI agents (such as Claude, Cursor, or Codex) to directly control and interact with a jailbroken iPhone. It bridges the gap between LLM-based agents and the physical iOS device, enabling automated testing, reverse engineering, and device management through a standardized protocol.

How it works

The project implements a Model Context Protocol (MCP) server that runs directly on a jailbroken iOS device. It exposes 46 different tools that an AI agent can call to perform actions on the device. These tools are categorized into several functional areas:

  • Touch and Input: Simulates precise screen coordinates for tapping, swiping, dragging, and typing text via HID simulation or the clipboard.
  • System Control: Manages apps (launch, kill, install, uninstall), controls hardware buttons (Home, Power, Volume), and adjusts system settings like brightness and volume.
  • Visuals and Accessibility: Takes screenshots, performs OCR on the screen, and retrieves the UI element tree for targeted interaction.
  • System Access: Provides access to the file system, system logs (syslog), and a shell for executing arbitrary commands.
  • Device Info: Retrieves device specifications, battery status, and jailbreak status.

Who it’s for

Developers, security researchers, and AI agent enthusiasts who own a jailbroken iOS device (supporting iOS 13 through 18) and want to integrate their mobile device into an AI-driven automation workflow.

Highlights

  • Comprehensive Toolset: 46 tools covering everything from basic touch gestures to deep system-level access.
  • Cros-Jailbreak Support: Compatible with rootful, rootless, and roothide jailbreaks across a wide range of iOS versions.
  • Accessibility Integration: Uses UI element trees and OCR to allow agents to "see" and interact with the screen intelligently.
  • ** uma root-level access:** Provides restricted root elevation capabilities for package management and system configuration.

Related

  • Project
    joshuayoes/ios-simulator-mcp

    An MCP server that enables AI agents to control iOS simulators, perform UI interactions, and automate QA testing through programmatic tool calls.

  • Project
    mobile-next/mobile-mcp

    Mobile MCP is an open‑source MCP server that lets AI agents control iOS/Android simulators, emulators, and real devices through a single API. It uses the native accessibility tree for fast, structured UI interaction, offers full device control (taps, swipes, app install, screen recording, etc.), and integrates with Claude, Gemini, Copilot, Codex and any MCP‑compatible client. Install via `npx @mobilenext/mobile-mcp@latest`, configure with a tiny JSON snippet, and run locally or as an SSE HTTP server.

  • Project
    steipete/macos-automator-mcp

    An MCP server that enables AI agents to control macOS applications and system functions by executing AppleScript and JavaScript for Automation (JXA) scripts.

  • Project
    getsentry/XcodeBuildMCP

    An MCP server and CLI that provides AI agents with tools to build and test iOS and macOS projects using xcodebuild.

  • Project
    appium/appium-mcp

    appium‑mcp is an AI‑enhanced Appium server that lets you control Android/iOS devices with natural‑language commands, auto‑generates robust locators and Java test code, and integrates with LLM‑powered IDEs. It runs as an MCP tool, supports vision‑based element finding via configurable OpenAI‑compatible models, and offers optional OpenTelemetry tracing and structured evidence for CI debugging.