Best for
- Teams developing iOS or macOS applications with macOS and Xcode
- Developers who want AI coding agents to participate in Xcode workflows
- Users who need both an MCP server and a unified CLI
X
XcodeBuildMCP
Community
An Xcode MCP server for iOS and macOS development
GitHub source repository ↗
51FMRS · D
Based on the repository description, server manifest, and README, XcodeBuildMCP provides a stdio MCP server and CLI focused on Xcode projects, simulators, and app development workflows. The source does not enumerate tool identifiers, so the tools list is empty; it also does not provide a reusable client JSON configuration.
XcodeBuildMCP is an MCP server and command-line tool that provides agent-oriented tools for working on iOS and macOS projects, including Xcode project management, simulator management, and app utilities. It supports both MCP server mode and direct terminal use.
Tools
The tool list has not been reviewed yet.
Setup
Requires macOS 14.5 or later and Xcode 16.x or later. With Homebrew: brew tap getsentry/xcodebuildmcp && brew install xcodebuildmcp. With Node.js 18+: npm install -g xcodebuildmcp@latest. Start the MCP server with xcodebuildmcp mcp, or run it on demand with npx -y xcodebuildmcp@latest mcp. Verify the installation with xcodebuildmcp --help.
Fit and risk
Not for
- Development environments without macOS or Xcode
- Users requiring native Windows or Linux support
- Users unwilling to grant local access to Xcode, simulators, or project operations
Required permissions
- Requires access to Xcode and related project workflows on macOS
- Device tools require code signing to be configured in Xcode
- Uses Sentry for internal runtime error telemetry by default; it can be disabled with XCODEBUILDMCP_SENTRY_DISABLED
Risks and side effects
- Device operations may fail when code signing is not configured
- The server asks xcodebuild to skip macro validation, which changes build behavior for projects using Swift Macros
- Internal runtime error telemetry is enabled by default
- Experimental incremental builds may be less stable
Troubleshooting
- Confirm macOS 14.5 or later and Xcode 16.x or later
- Confirm Node.js 18+ unless the Homebrew installation is used
- Run xcodebuildmcp --help to verify the installation
- Check Xcode code-signing configuration when device tools fail
- Set XCODEBUILDMCP_DEBUG=true for verbose debug logging
- Consult the official installation, configuration, CLI, and troubleshooting documentation
Use cases
Let an agent assist with Xcode project workflows through MCP
Build and test iOS or macOS targets on simulators
Manage simulators and related development operations
Run project builds, tests, and tool operations directly from the CLI
Supported clients
CursorPartial support
Claude CodePartial support
CodexPartial support