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

  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.

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.

247 881 1,514 Nov 6, 2026 Nov 16, 2026
GitHub stars for poki: 334 on Nov 6, 2026, 1,427 on Nov 16, 2026. Source: GitHub.

Ranking history

First ranked in week 46, 2026.

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.

Also compared with poki on these pages:

Last updated Nov 20, 2026. Tracked since Nov 6, 2026. Spotted an error? Tell us.