Skip to main content
Glama

ClickFast connects your iPhone to Codex and other AI agents. Your agent can open apps, tap buttons, enter text, scroll, and check the screen.

Try a task such as “Open Weather and search for São Paulo.” The agent reads the phone’s controls, chooses the actions, and checks the result.

ClickFast sends actions directly to the phone over USB. Several steps can run in one request, which cuts the wait between taps.

Setup

You need a Mac, Xcode, Node 22 or newer, and an iPhone with Developer Mode enabled. Xcode needs an Apple development team to sign the runner.

git clone https://github.com/xylotropic/ClickFast.git
cd ClickFast
brew install libusbmuxd
node scripts/setup.mjs --udid YOUR_PHONE_UDID --team YOUR_TEAM_ID
codex mcp add clickfast -- node "$PWD/src/cli.mjs" mcp

Keep the phone unlocked during setup. Once connected, ask Codex to try a small task. Other agents can use the same MCP connection.

You can also let JEV choose the next action from the current screen controls. That option needs a TypeSafe API key. See the setup and control reference.

Related MCP server: iphone-use

Results

Ten recorded Calculator and navigation tasks took 7.46 seconds with ClickFast and 30.53 seconds through iPhone Mirroring. Both completed all ten using known action plans. The timings include actions and result checks, but exclude setup and app launch. Watch the comparisons.

JEV completed 7 of 12 tasks in a separate test across more apps. General control still needs work. The full results include the failed attempts.

ClickFast sets media volume to zero before control. Apple still shows its system “Automation Running” screen during XCTest control.

Docs

MIT. Based on Callstack’s MIT release of iphone-use. License and credits.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables agents to control a physical iPhone from macOS through local phone tools, including USB capture, Bluetooth HID, and AssistiveTouch interactions. It also exposes relay tools for remote access over Streamable HTTP with optional OAuth.
      MIT
    • F
      license
      A
      quality
      A
      maintenance
      Control a real iPhone or iOS Simulator through a macOS daemon and XCTest runner over USB or Wi-Fi: read screen text, tap, type, swipe, inspect logs and replay flows with explicit outcomes. Browser sandbox: use readonly to inspect 12 preloaded flows without a phone. Reuse an existing sandbox from MCP Deployments, or delete it before starting another. Device control needs your Mac and iPhone.
      6
      43
      505
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to operate a real iPhone from a Mac by reading the screen over USB and sending taps, swipes, typing, and app launches over Bluetooth, with every action returning a fresh screenshot so the agent can verify its work. Runs as a local MCP server, so agents can test iOS apps on physical devices and automate everyday phone tasks.
      38 npm
      10
      MIT
    • A
      license
      B
      quality
      F
      maintenance
      Enables AI agents to see and operate a real USB-connected iPhone from a Linux Docker host — taking screenshots with region zoom, reading the element tree, tapping, swiping, long-pressing, typing text, pressing hardware buttons, listing/launching/terminating apps, and opening URLs. Automatically recovers from replugs and crashes, re-signs its automation agent before expiry, and falls back to a signing-free HID path on newer iOS.
      13
      MIT