Setup guides › Claude Code

Let Claude Code use your iPhone.

Add Spatia to Claude Code and it can see your iPhone's screen and tap, type and scroll for you, through iPhone Mirroring. One click in the setup assistant, or the exact config, with nothing to install on the phone.

Anthropic's agentic coding tool, in the Terminal and in the Code tab of the Claude app.

What you need

A Mac on macOS 15 Sequoia or later, with Claude Code installed.
An iPhone on iOS 18 or later, on the same Apple Account, nearby, with Wi-Fi and Bluetooth on.
Spatia, from the home page (free while it's in beta), moved to your Applications folder.

Set it up

Allow access. Open Spatia. Its setup assistant asks for Accessibility (to tap and type) and Screen Recording (to see the phone). They're granted to Spatia itself, not to Claude Code.
Connect your iPhone. Pair iPhone Mirroring once, with the phone locked and nearby. From then on Spatia connects for you.
Add it to Claude Code. In the setup assistant, click Add next to Claude Code. Or add it yourself:
Terminal
```
$ claude mcp add --scope user iphone -- "/Applications/Spatia.app/Contents/MacOS/iphone-mcp"
```
Or in ~/.claude.json:
~/.claude.json
```
{
  "mcpServers": {
    "iphone": {
      "command": "/Applications/Spatia.app/Contents/MacOS/iphone-mcp"
    }
  }
}
```
It goes in ~/.claude.json (user scope). The server is the iphone-mcp executable inside Spatia.app; nothing else is installed.
New Claude Code sessions have the iPhone tools.
Just ask. Every new Claude Code session, in the Terminal or the Code tab, with user scope.

Try asking

“Try signing up in my TestFlight build and tell me where it breaks.”
“Screenshot every screen of our onboarding flow into ./screens.”
“Open our app, go to Settings, and read me the version number.”
“Record a 20-second video of the checkout flow.”

How it works in Claude Code

Spatia is a local MCP server with 27 tools: Claude Code reads the iPhone's screen as words with tap points, so it taps on recognised text instead of guessing at pixels, and types exact text in any language. Every action can verify itself in the same call. The full list is in the developer section; how it compares with computer use, Appium and the open-source bridges is on the comparison page.

You stay in control: by default it asks before anything that sends, buys, posts or deletes, it never types a password, you can block apps by name, and the pause switch in the menu bar stops every tool at once. Picking up your iPhone stops it too.

Questions

Do I need to install anything on my iPhone to use it from Claude Code?

No. Spatia runs entirely on your Mac, through iPhone Mirroring. There's no app, profile or cable on the phone.

Where does Claude Code keep the Spatia config?

In ~/.claude.json (user scope). Spatia's setup assistant writes it for you and backs up the file first; the snippet above is exactly what it adds.

What can Claude Code do on my iPhone?

Open apps, read the screen as text, tap, type, scroll, swipe and take screenshots: 27 tools in all. It asks before anything that sends, buys, posts or deletes, never types a password, and you can pause it from the menu bar.