iOS MCP

An MCP server inside SpringBoard: an AI agent can take screenshots, read the accessibility tree and the live system log, tap, type, press the Action Button, open apps and more — 47 tools.

Based on witchan/ios-mcp 1.2.8, packaged for shivtools with safer defaults: it listens on 127.0.0.1 only, mcp-root comes without setuid, and installing a deb through it does not respring on its own.

Information

Usage

Connect an agent

shiv-mcp durum          # installed, running, which mode
shiv-mcp baglan         # the claude mcp add line for this phone
shiv-mcp baglan --mac   # SSH tunnel + claude mcp add for a Mac

shiv-mcp comes with shivtools. Restart the CLI after adding the server.

Security

The server has no authentication. By default it only accepts connections from the phone itself.

• shiv-mcp mod ag listens on the network — it asks first. Don't use it on public Wi-Fi.
• From a Mac, prefer the SSH tunnel: login and encryption come for free.
• shiv-mcp root-ac gives mcp-root its setuid bit. Only if you need root actions through the agent.

After installing

Respring once so SpringBoard loads the server. Settings → iOS MCP starts and stops it.

Licence

iOS MCP is MIT. The package also carries AppSync Unified and appinst (GPL-3.0) and ldid (AGPL-3.0), built unmodified from witchan/ios-mcp v1.2.8. Licence texts: /usr/share/doc/.

Changelog

1.2.8-3

• New tool: press_action_button — single, double or long press; works on the Lock Screen too.
• toggle_mute is described correctly: it is not the Action Button.

1.2.8-2

• Icon and depiction pages. The package contents are unchanged.

1.2.8-1

• Listens on 127.0.0.1 by default; network mode is a setting.
• mcp-root without setuid by default.
• Installing a deb no longer resprings by itself.
• Turkish interface.
• Everything included: server, OCR, IPA installer.

muratkurt · muratkurt.github.io · GitHub