poki-mcp — Claude Code skill: iPhone actions and setup
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.
AGPL-3.0-only ★ 1,754 updated 2026-11-16
npx skills add JosssphZhou/poki --skill poki-mcp -a claude-codeWhat poki-mcp 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.
What it helps with
- 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 for the agent
- 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.
How to install poki-mcp
1Skills CLI (Vercel)
npx skills add JosssphZhou/poki --skill poki-mcp -a claude-code2Manually: put the files in place
~/.claude/skills/poki-mcp/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/poki-mcp/
1Skills CLI (Vercel)
npx skills add JosssphZhou/poki --skill poki-mcp -a codex2Manually: put the files in place
.agents/skills/poki-mcp/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add JosssphZhou/poki --skill poki-mcp -a cursor2Manually: put the files in place
.cursor/skills/poki-mcp/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install JosssphZhou/poki skills/poki-mcp2Manually: put the files in place
.github/skills/poki-mcp/SKILL.md1Skills CLI (Vercel)
npx skills add JosssphZhou/poki --skill poki-mcp -a gemini-cli2Platform CLI
gemini skills install https://github.com/JosssphZhou/poki --path skills/poki-mcpManually: put the files in place
.devin/skills/poki-mcp/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about poki-mcp
How do I install poki-mcp in Claude Code?
Run npx skills add JosssphZhou/poki --skill poki-mcp -a claude-code. The skill file is placed at ~/.claude/skills/poki-mcp/SKILL.md.
What does poki-mcp do?
It guides an agent using Poki MCP to enter text and handle prompts on a physical iPhone. It also describes how to check the screen after actions and navigation.
What does poki-mcp need to work?
It requires Poki MCP and a physical iPhone. Poki Agent’s separate unlock feature requires the user to configure POKI_IPHONE_PASSCODE; the passcode must not be shared in chat.