blitzdotdev

blitzdotdev / iPhone-mcp

Public

MCP Server lets AI use an iPhone

blitz.dev
28
5
100% credibility
Found Mar 03, 2026 at 28 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

MCP server allowing AI agents to interact with iPhone simulators and physical devices on macOS for UI testing and automation.

How It Works

1
🔍 Discover the iPhone helper

You hear about a cool tool that lets smart AI friends play with your iPhone or fake iPhone on your Mac to test apps.

2
🛠️ Set it up on your Mac

You run a simple setup that adds the helper to your AI tools like Claude or Cursor, and it grabs what it needs like Xcode.

3
Pick your playground
💻
Use simulator

Open the fake iPhone app on your Mac—super easy, no cables.

🔌
Connect real iPhone

Plug in your phone with USB, trust your Mac, turn on developer mode, and let it prepare.

4
🤖 Tell your AI what to do

Chat with your AI buddy and say things like 'scan the screen' or 'test the login'.

5
✨ AI takes the wheel

Watch in awe as your AI scans buttons, taps around, swipes, types, and even shows a live view of the screen in your browser.

6
🧪 Run app tests

AI launches apps, tries crazy things, takes pictures, and spots weird problems.

✅ Get smart fixes

Your AI reports bugs with screenshots and ideas to make your app perfect—testing done effortlessly!

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 28 to 28 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is iPhone-mcp?

iPhone-mcp is a TypeScript-based MCP server that lets AI agents like Claude Code, Cursor, or any MCP-compatible client control real iPhones and simulators on macOS. Install via npm, run `npx @blitzdev/iphone-mcp --setup-all` for global config, then prompt your AI to scan screens, tap buttons, swipe, type, screenshot, or launch apps. It solves manual iOS testing by handing device control to AI, with tools like `scan_ui` for element detection and `device_action` for gestures.

Why is it gaining traction?

Unlike clunky Appium setups, it auto-detects devices, builds WebDriverAgent on-demand for physical iPhones, and offers a live browser viewer for mirroring. MCP server AI integration means zero custom code—just chat "test login flow" and watch it tap around. Quick regions like top-half scans keep AI loops fast, standing out in MCP GitHub examples for Cursor and Copilot users.

Who should use this?

iOS devs automating UI tests with AI agents, mobile QA engineers hunting bugs via natural language ("find edge cases in checkout"), or indie app builders validating flows on real hardware without Xcode UI tests. Perfect for Cursor/VSCode workflows needing iPhone MCP client access.

Verdict

Grab it if you're on macOS with AI-driven iOS work—early promise despite 28 stars and 1.0% credibility score from thin adoption. Docs are solid with troubleshooting, but expect setup hiccups on physical devices; test in simulator first for maturity check.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.