# ios-mcp-jailbreak-automation

The ios-mcp-jailbreak-automation skill for Claude Code connects an AI agent to an MCP server on a jailbroken iPhone to inspect its interface and operate apps.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 121 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/ios-mcp-jailbreak-automation/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ios-mcp-jailbreak-automation

## What it does

The skill describes MCP access to an iOS device. An agent can tap and swipe, enter text, capture screenshots, inspect the accessibility tree, and open or close apps. It can also read device details, handle clipboard contents, and run shell commands. These actions happen on the iPhone itself.

You need a jailbroken iPhone running iOS 13–18, with the iOS MCP package installed. Install that package through Cydia or Sileo, then enable the MCP service in the device settings and add its connection configuration to your agent. The package depends on `mobilesubstrate/ElleKit` and `preferenceloader`; without a jailbreak, its device-side MCP server cannot run.

The skill supports Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. The device server uses port `8090` by default. Jailbreak type determines which package architecture applies.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill ios-mcp-jailbreak-automation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ios-mcp-jailbreak-automation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ios-mcp-jailbreak-automation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill ios-mcp-jailbreak-automation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ios-mcp-jailbreak-automation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill ios-mcp-jailbreak-automation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ios-mcp-jailbreak-automation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/ios-mcp-jailbreak-automation
```

2. **Manually: put the files in place**
- File: `.github/skills/ios-mcp-jailbreak-automation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill ios-mcp-jailbreak-automation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/ios-mcp-jailbreak-automation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ios-mcp-jailbreak-automation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill ios-mcp-jailbreak-automation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/ios-mcp-jailbreak-automation/SKILL.md

## When to use it
- inspect an iPhone screen and its interface elements
- open an app or force it to close
- enter text and simulate screen gestures
- check iOS version, battery, and storage details
- install or remove an app on the device

## Example prompts
- Take a screenshot of the iPhone and describe the visible controls.
- Open Safari and tell me which app is currently in front.
- Enter text in the active field, then press Return.

## Similar
- [ios-device-automation](https://affpapa.org/en/nevibecode/skills/ios-device-automation.md) — skill · 3500 installs
- [argent-ios-device-setup](https://affpapa.org/en/nevibecode/skills/argent-ios-device-setup.md) — skill · 17100 installs
- [argent-ios-device-interact](https://affpapa.org/en/nevibecode/skills/argent-ios-device-interact.md) — skill · 17100 installs
- [ios-logos-tweak](https://affpapa.org/en/nevibecode/skills/ios-logos-tweak.md) — skill · ★ 107 repo stars
- [ios-marketing-capture-automation](https://affpapa.org/en/nevibecode/skills/ios-marketing-capture-automation.md) — skill · 1000 installs
- [Handsy AI](https://affpapa.org/en/nevibecode/mcp/handsy-ai.md) — MCP server · ★ 5197 repo stars

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
