XcodeBuildMCP

io.github.cameroncookePublished by GitHub account cameroncookev1.12.8Updated Oct 24, 2026

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

VerifiedSTDIODesktop onlyCloud & Infrastructure Developer Tools

Server details

Identifier: io.github.cameroncooke/XcodeBuildMCP
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account cameroncooke for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.cameroncooke%2FXcodeBuildMCP.svg)](https://sourceweft.com/mcp/io.github.cameroncooke%2FXcodeBuildMCP?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Lets an assistant build, test, and manage Xcode projects and iOS/macOS simulators from an agent workflow.

What you can do: XcodeBuildMCP is an MCP server and CLI that exposes tools for Xcode project management, simulator management, and app utilities. Agents can build schemes for simulators, prepare and run test products, capture logs, and debug through a per-workspace daemon. It also ships optional agent skills that prime an assistant on how to use the MCP tools or the CLI.
When to use it: Use it when an assistant needs to work on iOS or macOS projects: building apps, running simulator builds and tests, or inspecting build and log output. It is aimed at macOS developers who want an agent to drive Xcode workflows rather than run commands manually.
Requirements: macOS 14.5 or later, Xcode 16.x or later, and Node.js 18.x or later unless installed via Homebrew. Device tools require code signing configured in Xcode. No accounts, API keys, or environment variables are declared.

Before you install

It runs locally and can build and test projects, which writes build and test artifacts and starts a per-workspace daemon. It requests that xcodebuild skip macro validation, which may hide macro-related errors. It uses Sentry for internal runtime error telemetry, with opt-out instructions in its privacy documentation.

Installation

In SourceWeft

Open XcodeBuildMCP in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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] [pkg.pr.new]

Installation

MobileBuildMCP 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 mobilebuildmcp@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

MobileBuildMCP 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

MobileBuildMCP 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

MobileBuildMCP uses Sentry for internal runtime error telemetry only. For details and opt-out instructions, see Privacy & Telemetry.

CLI

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

bash

# Install globallynpm install -g mobilebuildmcp@latest
# Start the MCP server (for MCP clients)mobilebuildmcp mcp
# List available toolsmobilebuildmcp tools
# Build for simulatormobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj
# Prepare portable test products without running testsmobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17" --build-for-testing --test-products-path ./MyApp.xctestproducts
# Run previously prepared test productsmobilebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

# Install globallynpm install -g mobilebuildmcp@latest
# Start the MCP server (for MCP clients)mobilebuildmcp mcp
# List available toolsmobilebuildmcp tools
# Build for simulatormobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj
# Prepare portable test products without running testsmobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17" --build-for-testing --test-products-path ./MyApp.xctestproducts
# Run previously prepared test productsmobilebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

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://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/installation.mdx
Setup: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/setup.mdx
MCP clients: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/clients.mdx
CLI usage: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/cli.mdx
Configuration and options: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx
Tools reference: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx
Troubleshooting: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/troubleshooting.mdx
Privacy: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/privacy.mdx
Skills: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/skills.mdx
Contributing: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/contributing.mdx

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.

Source: README.md at commit d13ff0c

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.12.8LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts