Poki

Overview

Poki is an open-source local MCP server and agent for controlling a real iPhone from a Mac. It uses native touch events to operate real iOS apps and system interfaces without jailbreak or extra hardware. Verified runs compile into routes, so similar tasks take a shorter path on repeat.

Key Features

• Poki Agent is an autonomous iPhone agent with self-learning routes.
• Poki MCP is a standard MCP server for iPhone control.
• Verified runs compile into routes, making repeated tasks take a shorter path.
• Integrations include Claude Code, Codex, iMessage, and Terminal, with Telegram marked coming soon.
• Poki controls a real iPhone through a Mac with native touch events, without jailbreak or external hardware.
• Poki MCP and Poki Agent are open source under AGPL-3.0.

Use Cases

• Add a shopping list from an iMessage conversation into Reminders.
• Operate real iOS apps and system interfaces such as Xiaohongshu saved places, Maps directions, and WeChat sending.
• Read Alipay bills, calculate category totals, and write the summary into Notes.
• Search Trip.com train options, stop before payment, and add the selected train to Calendar.

Getting Started

• Clone the repository, run ./bin/setup, then start the server with npm start.
• Register the MCP server with claude mcp add --scope user poki-mcp -- node "$PWD/src/stdio.mjs" for Claude Code, or codex mcp add poki-mcp -- node "$PWD/src/stdio.mjs" for Codex.
• For Poki Agent, run npm ci --prefix agent, add the bin directory to PATH, then run poki login and poki status.

Deployment & Requirements

• Source setup requires macOS 15 or later, full Xcode, Rust, Node.js 24+, and ffmpeg.
• The prebuilt macOS arm64 package requires Apple Silicon macOS, full Xcode, Node.js 24+, Python 3, and ffmpeg; Rust and ./bin/setup are not required.
• For a physical iPhone, pair it with the Mac over USB first.

Before You Adopt

• License: AGPL-3.0. Review its terms before using, modifying, or distributing the project.
• Poki acts on a real iPhone and can send messages or make payments when asked; screen contents are sent to the configured model service.
• Automating third-party apps and websites may violate their terms of service, so use with a given service is the user's decision.
• Physical iPhone support has verified limits: only Chinese-interface iPhones have been verified, portrait orientation only is supported, and some capabilities are unavailable.