XcodeBuildMCP

<img src="banner.png" alt="XcodeBuild MCP" width="600"/> A Model Context Protocol (MCP) server that provides Xcode-related tools for integration with AI assistants and other MCP clients. [](https://github.com/cameroncooke/XcodeBuildMCP/actions/workflows/ci.yml) [](https://badge.fury.io/js/xcodebuildmcp) [](https://opensource.org/licenses/MIT) [](https://nodejs.org/) [](https://developer.apple.com/xcode/) [](https://www.apple.com/macos/) [](https://modelcontextprotocol.io/) [](https://deepwiki.com/cameroncooke/XcodeBuildMCP) ## Table of contents - [Overview](#overview) - [Why?](#why) - [Features](#features) - [Xcode project management](#xcode-project-management) - [Swift Package Manager](#swift-package-manager) - [Simulator management](#simulator-management) - [Device management](#device-management) - [App utilities](#app-utilities) - [MCP Resources](#mcp-resources) - [Getting started](#getting-started) - [Prerequisites](#prerequisites) - [Configure your MCP client](#configure-your-mcp-client) - [One click install](#one-click-install) - [General installation](#general-installation) - [Specific client installation instructions](#specific-client-installation-instructions) - [OpenAI Codex CLI](#openai-codex-cli) - [Claude Code CLI](#claude-code-cli) - [Smithery](#smithery) - [MCP Compatibility](#mcp-compatibility) - [Incremental build support](#incremental-build-support) - [Dynamic Tools](#dynamic-tools) - [What is Dynamic Tools?](#what-is-dynamic-tools) - [How to Enable Dynamic Tools](#how-to-enable-dynamic-tools) - [Usage Example](#usage-example) - [Client Compatibility](#client-compatibility) - [Selective Workflow Loading (Static Mode)](#selective-workflow-loading-static-mode) - [Code Signing for Device Deployment](#code-signing-for-device-deployment) - [Troubleshooting](#troubleshooting) - [Doctor Tool](#doctor-tool) - [Privacy](#privacy) - [What is sent to Sentry?](#what-is-sent-to-sentry) - [Opting Out of Sentry](#opting-out-of-sentry) - [Demos](#demos) - [Autonomously fixing build errors in Cursor](#autonomously-fixing-build-errors-in-cursor) - [Utilising the new UI automation and screen capture features](#utilising-the-new-ui-automation-and-screen-capture-features) - [Building and running iOS app in Claude Desktop](#building-and-running-ios-app-in-claude-desktop) - [Contributing](#contributing) - [Licence](#licence) ## Overview XcodeBuildMCP is a Model Context Protocol (MCP) server that exposes Xcode operations as tools and resources for AI assistants and other MCP clients. Built with a modern plugin architecture, it provides a comprehensive set of self-contained tools organized into workflow-based directories, plus MCP resources for efficient data access, enabling programmatic interaction with Xcode projects, simulators, devices, and Swift packages through a standardized interface.  <caption>Using Cursor to build, install, and launch an app on the iOS simulator while capturing logs at run-time.</caption> ## Why? The XcodeBuild MCP tool exists primarily to streamline and standardise interaction between AI agents and Xcode projects. By providing dedicated tools for common Xcode operations, it removes reliance on manual or potentially incorrect command-line invocations. This ensures a reliable and efficient development process, allowing agents to seamlessly leverage Xcode's capabilities while reducing the risk of configuration errors. Critically, this MCP enables AI agents to independently validate code changes by building projects, inspecting errors, and iterating autonomously. In contrast to user-driven tools like Sweetpad, XcodeBuild MCP empowers agents to automate these workflows effectively. ## Features The XcodeBuildMCP server provides the following tool capabilities: ### Xcode project management - **Discover Projects**: Xcode projects and workspaces discovery - **Build Operations**: Platform-specific build tools for macOS, iOS simulator, and iOS device targets - **Project Information**: Tools to list schemes and show build settings for Xcode projects and workspaces - **Clean Operations**: Clean build products using xcodebuild's native clean action - **Incremental build support**: Lightning fast builds using incremental build support (experimental, opt-in required) - **Project Scaffolding**: Create new iOS and mac