xcodebuildmcp weekly downloads statistics

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

Option B — npm (Node.js 18+)

Verify either install:

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:

Or install directly via npx without a global install:

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:

Check for updates and upgrade in place:

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.

Description from the npm listing.