# poki-mcp

This Claude Code and Codex skill guides Poki MCP actions on a physical iPhone. It applies to tasks that enter text, handle system prompts, or use hardware buttons.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1754 repo stars
- Author: JosssphZhou
- License: AGPL-3.0-only · policy=link-only · description only; the file stays with the author
- Source: https://github.com/JosssphZhou/poki/tree/HEAD/skills/poki-mcp/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/poki-mcp

## What it does

poki-mcp tells an agent how to operate a physical iPhone through Poki MCP, including text entry, system dialogs, and navigation to the Home screen. It calls for checking the displayed screen after an action and retrying only unfinished steps when field confirmation fails.

To expose the full tool catalog, set `POKI_MCP_TOOLS=all` in the MCP client’s process environment and reconnect; `run_code` is available only in that catalog. iPhone unlocking is a separate setup choice made by the user. The passcode must not be requested in chat; without that setup, the agent asks the user to unlock the phone manually.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add JosssphZhou/poki --skill poki-mcp -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add JosssphZhou/poki --skill poki-mcp -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add JosssphZhou/poki --skill poki-mcp -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install JosssphZhou/poki skills/poki-mcp
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add JosssphZhou/poki --skill poki-mcp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/JosssphZhou/poki --path skills/poki-mcp
```

### Windsurf (Devin Desktop)

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

### 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/JosssphZhou/poki/tree/HEAD/skills/poki-mcp/SKILL.md

## When to use it
- enter and submit prepared text in an iPhone field
- respond to a system prompt or app dialog
- navigate to the iPhone Home screen and verify the result

## Example prompts
- Type “Done” in the open field and submit it.
- Read the system prompt on screen and dismiss it with the appropriate button.
- Go to the iPhone Home screen and confirm what appears.

## Similar
- [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-device-automation](https://affpapa.org/en/nevibecode/skills/ios-device-automation.md) — skill · 3500 installs
- [Handsy AI](https://affpapa.org/en/nevibecode/mcp/handsy-ai.md) — MCP server · ★ 5197 repo stars
- [call-me](https://affpapa.org/en/nevibecode/plugins/call-me.md) — plugin · ★ 1596 repo stars

From the same set: [josssphzhou/poki](https://affpapa.org/en/nevibecode/by/josssphzhou/poki.md) — 5 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
