PluginBench
MCP Server
Active
MIT

io.github.cameroncooke/XcodeBuildMCP MCP Server

io.github.cameroncooke/XcodeBuildMCP

Give AI coding agents direct control over Xcode builds, simulators, and app management.

RepositoryRegistry
How to choose

What this kind of tool is for

  • Automate a build, test, or deployment step you repeat by hand.
  • Review or refactor code in an existing repository without leaving your agent.
  • Bridge an internal service or CLI into the agent toolset.

How to compare servers like this

Scope of control:
Repos and CI are hard to undo; prefer tools that ask before anything irreversible.
Environment fit:
Match the runtime it expects (Node, Python, a container) to what you actually run.
Maintenance signal:
Check the last-commit date — dev tooling that lags upstream breaks first.
Config surface:
Prefer tools whose environment-variable or config keys are documented plainly.

This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.

What is the io.github.cameroncooke/XcodeBuildMCP MCP server?

XcodeBuildMCP is a Model Context Protocol server and CLI that gives AI coding agents (like Claude Code and Cursor) tools to build, manage, and test iOS and macOS Xcode projects. It exposes capabilities for Xcode project management, simulator management, and app utilities, and can run either as an MCP server for AI clients or as a standalone command-line tool.

XcodeBuildMCP is a single package that ships both an MCP server and a CLI for working with Xcode projects. It lets AI agents (or a developer via terminal) build projects, manage iOS/macOS simulators, and run app utilities without manually driving Xcode. It requires macOS 14.5+, Xcode 16+, and can be installed via Homebrew or npm; device tools additionally require code signing to be configured in Xcode.

How to install io.github.cameroncooke/XcodeBuildMCP

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
~/Library/Application Support/Claude/claude_desktop_config.json
JSON config
{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp"
      ]
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

  • simulator build — Build a project for the iOS Simulator, e.g. via `xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj`.
  • tools — List available tools exposed by the CLI/MCP server.
  • mcp — Start the MCP server for use by MCP clients such as Cursor or Claude Code.
  • upgrade — Check for and apply updates to the XcodeBuildMCP installation.
  • init — Install optional agent skills (MCP Skill or CLI Skill) to prime an agent with usage instructions.

Use cases

  • Build an iOS/macOS app for the simulator directly from an AI coding assistant
  • Manage and control iOS simulators (e.g. launching, installing apps) via agent or CLI commands
  • Let an AI agent inspect and drive Xcode project builds without manual Xcode interaction
  • Use the CLI to script Xcode builds and simulator operations in automation/CI
  • Capture logs and debug apps using the CLI's per-workspace daemon

io.github.cameroncooke/XcodeBuildMCP MCP server FAQ

What does XcodeBuildMCP do?

It provides tools for Xcode project management, iOS/macOS simulator management, and app utilities, accessible either through an MCP server for AI agents or through a unified CLI for direct terminal use.

Is XcodeBuildMCP free?

Yes, it's open source under the MIT License and free to install via Homebrew or npm.

How do I install XcodeBuildMCP for use with Cursor or Claude Code?

Install it via Homebrew (`brew tap getsentry/xcodebuildmcp && brew install xcodebuildmcp`) or npm (`npm install -g xcodebuildmcp@latest`), then add the client config snippet from the official docs, or run it on demand with `npx -y xcodebuildmcp@latest mcp` without a global install.

Is authentication required to use XcodeBuildMCP?

No account or API key is required, but device (physical hardware) tools require code signing to be set up in Xcode.

What are the system requirements?

macOS 14.5 or later, Xcode 16.x or later, and Node.js 18.x or later (Node.js is not required if installing via Homebrew).

Does XcodeBuildMCP collect any data?

It uses Sentry for internal runtime error telemetry only; details and opt-out instructions are documented on the project's Privacy & Telemetry page.

README (reference)

Source of truth, from the repository.

<img src="assets/banner.png" alt="XcodeBuild MCP" width="600"/>

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

CI npm version License: MIT Node.js Xcode 16 macOS MCP Ask DeepWiki AgentAudit Security

Installation

XcodeBuildMCP ships as a single package with two modes: a CLI for direct terminal use and an MCP server for AI coding agents. Either install method gives you both.

Option A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

Option B — npm (Node.js 18+)

npm install -g xcodebuildmcp@latest

Verify either install:

xcodebuildmcp --help

Connect your MCP client

Drop-in config snippets for Cursor, Claude Code, Codex, can be found in the official docs page MCP Clients. Most clients can also run the MCP server on demand via npx -y xcodebuildmcp@latest mcp without a global install.

Requirements

  • macOS 14.5 or later
  • Xcode 16.x or later
  • Node.js 18.x or later (not required for Homebrew installation)

Skills

XcodeBuildMCP now includes two optional agent skills:

  • MCP Skill: Primes the agent with instructions on how to use the MCP server's tools (optional when using the MCP server).

  • CLI Skill: Primes the agent with instructions on how to navigate the CLI (recommended when using the CLI).

To install with a global binary:

xcodebuildmcp init

Or install directly via npx without a global install:

npx -y xcodebuildmcp@latest init

For further information on installing skills, see Agent Skills.

Notes

  • XcodeBuildMCP requests xcodebuild to skip macro validation to avoid errors when building projects that use Swift Macros.
  • Device tools require code signing to be configured in Xcode. See Device Code Signing.

Privacy

XcodeBuildMCP uses Sentry for internal runtime error telemetry only. For details and opt-out instructions, see Privacy & Telemetry.

CLI

XcodeBuildMCP provides a unified command-line interface. The mcp subcommand starts the MCP server, while all other commands provide direct terminal access to tools:

# Install globally
npm install -g xcodebuildmcp@latest

# Start the MCP server (for MCP clients)
xcodebuildmcp mcp

# List available tools
xcodebuildmcp tools

# Build for simulator
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj

Check for updates and upgrade in place:

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

The CLI uses a per-workspace daemon for stateful operations (log capture, debugging, etc.) that auto-starts when needed. See the CLI guide for full documentation.

Documentation

Licence

This project is licensed under the MIT License - see the LICENSE file for details. For third-party licensing notices see the THIRD_PARTY_LICENSES file for details. For npm package attributions see the THIRD_PARTY_PACKAGE_LICENSES file for details.

Related MCP servers

Persistent, portable memory for AI coding agents across sessions and machines.

11
JavaScript
MIT
View repository →
FEFeatureflip logo

Manage Featureflip feature flags, targeting and rollouts from AI agents and editors.

0
TypeScript
Apache-2.0
View repository →

MCP server mode for Qoder CLI — delegate coding tasks to local Qoder agents from any MCP client.

0
JavaScript
MIT
View repository →

AI-assisted development for SAP CAP applications with semantic search of models and documentation.

99
JavaScript
Apache-2.0
View repository →

Fediverse client for LLMs—explore Mastodon, Misskey, Pleroma, and ActivityPub servers safely.

16
TypeScript
MIT
View repository →

Browse Gopher and Gemini protocol resources safely with SSRF protection, TLS/TOFU validation, and structured JSON output.

12
Python
MIT
View repository →