maxpproppo/XcodeBuildMCP: A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects. · GitHub

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

This fork is the internal hardened build of XcodeBuildMCP. It removes Sentry telemetry and disables automatic template and helper downloads by default.

Use the internal install guide instead of the upstream Homebrew tap or the public xcodebuildmcp@latest npm package:

• Internal Install

• macOS 14.5 or later
• Xcode 16.x or later
• Node.js 18.x or later

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).

After installing the internal global binary:

xcodebuildmcp init

For further information on installing skills, see Agent Skills.

• 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.

This hardened fork removes Sentry telemetry from the runtime. The doctor command reports Sentry telemetry: Removed in this hardened build.

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

# 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

Use Internal Install to update from the internal fork. Do not use xcodebuildmcp upgrade, which is designed for the public upstream package.

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.

• Internal installation: Internal Install
• 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

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.