Blitz MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone https://github.com/blitzdotdev/blitz-mac.git
cd blitz-mac
swift build -c release
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add blitz-mac -- node "<FULL_PATH_TO_BLITZ_MAC>/dist/index.js"

Replace <FULL_PATH_TO_BLITZ_MAC>/dist/index.js with the actual folder you prepared in step 1.

README.md

Native macOS app for building, testing, and shipping iOS apps with AI agents

Blitz

Native macOS app for building, testing, and shipping iOS apps with AI agents

Blitz is a native macOS app that gives AI agents full control over the iOS development lifecycle — simulator/iPhone management, database setup, and App Store Connect submission. It includes built-in MCP servers so Claude Code (or any MCP client) can build, test, and submit your app to the App Store.

Demo: submitting an app to App Store Connect for review

https://github.com/user-attachments/assets/07364d9f-f6a7-4375-acc8-b7ab46dcc60e

Requirements

  • macOS 14+ (Sonoma)
  • Xcode 16+ (Swift 5.10+)
  • Node.js 18+ (for build scripts and sidecar)

Download

Download from website

Build from source

# Clone
git clone https://github.com/blitzdotdev/blitz-mac.git
cd blitz-mac

# Debug build
swift build

# Release build
swift build -c release

# Bundle as .app (ad-hoc signed)
bash scripts/bundle.sh release

# The app is at .build/Blitz.app
open .build/Blitz.app

For signed builds, copy .env.example to .env and fill in your Apple Developer credentials, then run:

bash scripts/bundle.sh release

Verify a release binary

Every GitHub release includes SHA256SUMS.txt with checksums of the CI-built binary. To verify: claude-mono (1).md Option 1: Check a downloaded binary against release checksums

# Download both Blitz.app.zip and SHA256SUMS.txt from the GitHub release
shasum -a 256 -c SHA256SUMS.txt

Option 2: Build from source and compare

bash scripts/verify-build.sh v1.0.20

This builds the app locally and compares the main executable checksum against the release. CI builds use ad-hoc signing, so checksums match when you build with the same toolchain.

Option 3: Inspect the CI build yourself

All release binaries are built by the public GitHub Actions workflow. The workflow is transparent — you can audit every step and verify that the published artifact matches what the workflow produced.

Security and privacy

  • No analytics or telemetry. The app makes zero tracking calls. No data is collected about your usage.
  • No phone-home. The only network requests are to Apple's App Store Connect API (when you use ASC features) and GitHub's releases API for optional update checks.
  • MCP server is localhost-only. The built-in MCP server binds to 127.0.0.1 and is never exposed to the network.
  • No access to sensitive data. The app does not access your contacts, photos, location, or any personal data. Screen capture is limited to the iOS Simulator window.

Architecture

Single-target SwiftUI app built with Swift Package Manager. All source lives in src/. See CLAUDE.md for detailed architecture documentation.

License

Apache License 2.0

Tools (3)

manage_simulatorBoot, shutdown, or manage iOS simulators.
trigger_buildInitiate an Xcode build process for the current project.
submit_to_ascSubmit the built application to App Store Connect for review.

Environment Variables

APPLE_DEVELOPER_CREDENTIALSCredentials required for App Store Connect submission features.

Configuration

claude_desktop_config.json
{"mcpServers": {"blitz": {"command": "/path/to/blitz-mcp-executable"}}}

Try it

Boot the iPhone 15 Pro simulator and launch my current project.
Run the build process for the release configuration.
Submit the latest build to App Store Connect for review.
Check the status of my current iOS simulator.

Frequently Asked Questions

What are the key features of Blitz?

Full control over iOS simulator and physical iPhone management. Automated build triggering for Xcode projects. Direct submission to App Store Connect via MCP tools. Localhost-only MCP server for secure development. Zero telemetry or tracking for privacy.

What can I use Blitz for?

Automating the build and test cycle for iOS developers using AI agents. Streamlining the App Store Connect submission process for faster releases. Managing multiple iOS simulator instances programmatically via Claude. Integrating AI-driven debugging workflows directly into the Xcode development lifecycle.

How do I install Blitz?

Install Blitz by running: git clone https://github.com/blitzdotdev/blitz-mac.git && cd blitz-mac && swift build -c release

What MCP clients work with Blitz?

Blitz works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Blitz docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare