XcodeBuildMCP

com.xcodebuildmcpPublished by xcodebuildmcp.comv2.7.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyCloud & Infrastructure Developer Tools

Server details

Identifier: com.xcodebuildmcp/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 that this server's namespace belongs to xcodebuildmcp.com. It runs from a package rather than a hosted endpoint, so there is no endpoint to match against that domain.

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/com.xcodebuildmcp%2FXcodeBuildMCP.svg)](https://sourceweft.com/mcp/com.xcodebuildmcp%2FXcodeBuildMCP?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

MCP server and CLI that lets an AI agent build, test and run iOS and macOS Xcode projects, manage simulators and devices, and use app utilities.

What you can do: Build and test Xcode projects and workspaces, including build-for-testing and running prepared test products
Discover projects, schemes and targets
Manage simulators and devices, including launching apps and capturing logs
Run app utilities and debugging operations through a per-workspace daemon
Also usable as a command-line tool with the same tools, plus update checks
When to use it: Useful when an assistant should work inside an iOS or macOS codebase: compiling, running tests on simulators or devices, and inspecting build or runtime output without you copying commands back and forth.
Requirements: Runs locally on macOS 14.5 or later with Xcode 16.x or later; Node.js 18+ for the npm/npx install (not needed with Homebrew). Device tools need code signing configured in Xcode. Optional environment variables: INCREMENTAL_BUILDS_ENABLED, XCODEBUILDMCP_DEBUG, XCODEBUILDMCP_ENABLED_WORKFLOWS, XCODEBUILDMCP_SENTRY_DISABLED.

Before you install

Builds, tests and device operations act on your local projects and simulators or devices, so the agent can change build outputs and run code. Device tools require code signing credentials set up in Xcode. The server sends runtime error telemetry to Sentry by default; set XCODEBUILDMCP_SENTRY_DISABLED to opt out. It also asks xcodebuild to skip macro validation.

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

v2.7.0LatestSep 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