Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add JosssphZhou/poki --skill poki-mcp -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/poki-mcp/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/poki-mcp/

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.

Similar skills

All skills for Mobile →

From the same set5

Project sponsors

Companies that keep this analytics open