XcodeBuildMCP

Name: XcodeBuildMCP
Author: getsentry

getsentry/XcodeBuildMCP

6.2k repo stars
Updated July 23, 2026
getsentry/XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

About

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities. Exposes 5 MCP tools including com.xcodebuildmcp/XcodeBuildMCP, INCREMENTAL_BUILDS_ENABLED, XCODEBUILDMCP_ENABLED_WORKFLOWS, XCODEBUILDMCP_SENTRY_DISABLED. Install via Claude Desktop, Cursor, or any MCP-compatible client using the upstream server manifest.

Node.js 18.x or later (not required for Homebrew installation)
**CLI Skill**: Primes the agent with instructions on how to navigate the CLI (recommended when using the CLI).
Installation: [https://xcodebuildmcp.com/docs/installation](https://xcodebuildmcp.com/docs/installation)
Setup: [https://xcodebuildmcp.com/docs/setup](https://xcodebuildmcp.com/docs/setup)
MCP clients: [https://xcodebuildmcp.com/docs/clients](https://xcodebuildmcp.com/docs/clients)

XcodeBuildMCP by the numbers

Data as of Jul 28, 2026 (Skillselion catalog sync)

terminal

claude mcp add --env INCREMENTAL_BUILDS_ENABLED=YOUR_INCREMENTAL_BUILDS_ENABLED --env XCODEBUILDMCP_ENABLED_WORKFLOWS=YOUR_XCODEBUILDMCP_ENABLED_WORKFLOWS --env XCODEBUILDMCP_SENTRY_DISABLED=YOUR_XCODEBUILDMCP_SENTRY_DISABLED --env XCODEBUILDMCP_DEBUG=YOUR_XCODEBUILDMCP_DEBUG xcodebuildmcp -- npx -y xcodebuildmcp

Add your badge

Show developers this MCP server is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/mcp/tool/com.xcodebuildmcp/XcodeBuildMCP.svg)](https://skillselion.com/mcp/tool/com.xcodebuildmcp/XcodeBuildMCP)

repo stars	★ 6.2k
Package	xcodebuildmcp
Transport	STDIO
Auth	None
Last updated	July 23, 2026
Repository	getsentry/XcodeBuildMCP ↗

How do I connect XcodeBuildMCP to my MCP client?

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

Who is it for?

Teams wiring XcodeBuildMCP into Claude, Cursor, or custom agents for developer tools.

Skip if: Skip when you need a non-MCP SDK or hosted API without stdio/SSE transport.

What you get

Working XcodeBuildMCP MCP server with verified tool registration and client config.

Agent-invokable Xcode build and simulator workflows
Configurable workflow loading at MCP startup
Faster edit-build-run loops without leaving the agent

By the numbers

[object Object]

At a glance

XcodeBuildMCP capabilities & compatibility

Capabilities: xcodebuildmcp mcp tool registration · xcodebuildmcp client configuration · xcodebuildmcp agent workflow integration
Use cases: orchestration
Runs: Remote server

From the docs

What XcodeBuildMCP says it does

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

README.md

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

README.md

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

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

Installation: https://xcodebuildmcp.com/docs/installation
Setup: https://xcodebuildmcp.com/docs/setup
MCP clients: https://xcodebuildmcp.com/docs/clients
CLI usage: https://xcodebuildmcp.com/docs/cli
Configuration and options: https://xcodebuildmcp.com/docs/configuration
Tools reference: https://xcodebuildmcp.com/docs/tools
Troubleshooting: https://xcodebuildmcp.com/docs/troubleshooting
Privacy: https://xcodebuildmcp.com/docs/privacy
Skills: https://xcodebuildmcp.com/docs/skills
Contributing: https://xcodebuildmcp.com/docs/contributing

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.