poki
Poki is an MCP server and phone agent that lets AI tools like Claude Code and Codex operate a real iPhone for people automating phone tasks.
What it is good for
- Automating repetitive tasks on a real iPhone
- Letting an AI assistant tap and type in phone apps
- Sending messages or searching in apps through an AI agent
- Controlling an iPhone remotely from Telegram or iMessage
At a glance
- Who it is for
- Setup difficulty
- Technical ยท Guided command-line setup
Level 4 of 5. You copy and paste commands into a terminal by following the instructions. Comfortable territory for vibe coders.
- Cost
- Free and open source
- Type
- MCP server or connector
- Tasks
- Works with
- Claude Code, Codex, iPhone, Telegram, iMessage, Karing
How to get started with poki
- Ask Claude Code or Codex on your Mac to install Poki on your iPhone from the GitHub repository.
- Type your Apple Account into the Poki Setup window on the Mac when asked.
- Tap Trust and turn on Developer Mode on the iPhone, then trust the developer and open Poki.
- Enable UI Automation in the iPhone's Developer settings and configure model access in Poki.
- Run a first task, for example searching in Chrome, with the
pokicommand.
From the project's own documentation. If a step does not match what you see, the official pages have the latest instructions.
Before you try it
- Requires macOS 14+, Node.js 24+, iOS 18+, a USB data cable, and an Apple Account.
- Free Apple Account signing lasts 7 days and needs renewal.
- Poki controls your real iPhone and will send messages or make payments if asked.
- Screen contents are sent to your configured model service.
Momentum
- Rank this week
- #24
- Best rank
- #24 week 46, 2026
- Stars gained last week
- +786
- GitHub stars
- 1,427
GitHub numbers as of Nov 16, 2026. Updated weekly.
Ranking history
Official links
Questions
- Is poki free?
- Yes. It is free and open source (AGPL-3.0 license).
- Do I need to know how to code to use poki?
- You do not need to write code, but setup means copying and pasting commands into a terminal by following its instructions.
- What does poki work with?
- According to its own documentation, it works with Claude Code, Codex, iPhone, Telegram, iMessage, and Karing.
- How do I get started with poki?
- 1. Ask Claude Code or Codex on your Mac to install Poki on your iPhone from the GitHub repository. 2. Type your Apple Account into the Poki Setup window on the Mac when asked. 3. Tap Trust and turn on Developer Mode on the iPhone, then trust the developer and open Poki. 4. Enable UI Automation in the iPhone's Developer settings and configure model access in Poki. 5. Run a first task, for example searching in Chrome, with the poki command.
- What should I know before trying poki?
- Requires macOS 14+, Node.js 24+, iOS 18+, a USB data cable, and an Apple Account. Free Apple Account signing lasts 7 days and needs renewal. Poki controls your real iPhone and will send messages or make payments if asked. Screen contents are sent to your configured model service.
- What is poki good for?
- Automating repetitive tasks on a real iPhone, letting an AI assistant tap and type in phone apps, sending messages or searching in apps through an AI agent, and controlling an iPhone remotely from Telegram or iMessage.
Similar agents to poki
- iphone-use
Also a self-hosted tool for controlling a real iPhone, with a different setup and feature set.
- Phone-use
A command-line tool for driving a real phone, rather than an MCP server plus built-in agent.
- mobile-mcp
Covers iOS and Android simulators, emulators, and real devices, aimed at testing and automation.
- Peekaboo
Controls the Mac screen and apps instead of an iPhone.
- computer-control-mcp
Operates a desktop computer with mouse and keyboard rather than a phone.
- ESP32 iPhone Agent
ESP32 iPhone Agent is an agent app that lets an AI model see and operate a real iPhone through a $7 ESP32 board for tinkerers.