πŸ”§

XcodeBuild MCP

πŸ”§MCP Server

Lets Claude Code and other AI coding tools build and work on your iOS and macOS apps through Xcode. You can also run the same tools yourself from the terminal.

getsentry/XcodeBuildMCP6,044Last Updated Jul 6, 2026

Installation

No Claude Code install command was found in the README. See the README for how to set it up.Read the README β†’

What this MCP server does

Overview

XcodeBuildMCP gives AI agents tools for working on iOS and macOS projects with Xcode, Apple's app development tool. It comes as one package with two modes: an MCP server, which connects the tools to AI agents, and a command-line tool you use directly in the terminal. For example, xcodebuildmcp simulator build builds your app for the simulator, a virtual device that runs on your Mac.

Key Features

  • Install it with Homebrew or npm, and run xcodebuildmcp --help to check the install.
  • Connect it to Cursor, Claude Code or Codex, or start it only when needed with npx -y xcodebuildmcp@latest mcp.
  • Run tools from the terminal, such as xcodebuildmcp tools to list them or xcodebuildmcp simulator build to build.
  • Capture logs and debug your app through a background helper that starts by itself when needed.
  • Add optional skills that teach the agent how to use the server or the terminal tool with xcodebuildmcp init.

Who is this for?

It fits iOS and macOS developers who want an AI agent to build and debug their Xcode projects. You need macOS 14.5 or later, Xcode 16 or later, and Node.js 18 or later (Node.js is not needed with Homebrew).

Summarized by AI from this repo's README. Suggest a better one

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.

More from this repository4