M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
X

XcodeBuildMCP

Community
An Xcode MCP server for iOS and macOS development
How to install ↓ Compare GitHub source repository ↗
Category
Dev Tools #243 of 438
Stars
★ 6.5k Very popular
Transport
stdio (local process)
Runtime
Node.js 18+ · Prebuilt binary
Credentials
No credential needed
License
MIT
Last commit
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.

Strongest · Maintenance 12/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
9/20
Maintenance
12/20
Documentation
11/20
Setup experience
11/20
Why each score
Reliability 8/20
The manifest specifies an npm package, stdio transport, and version, while the README provides plausible startup and CLI examples. However, the supplied material does not verify MCP initialization, tool-list handshake, correspondence between declared and implemented tools, error handling, or dependency-failure behavior; a CI badge is not inspectable execution evidence. This warrants a conservative score below the static-review ceiling of 12.
Security and permissions 9/20
The material discloses Sentry runtime error telemetry and an opt-out variable, and notes that device tools involve code signing; the stated scope is local Xcode, simulator, and project work. No source evidence is provided for permission boundaries, data-flow scope, network behavior, dangerous-operation confirmation, or credential handling, so least privilege and side-effect controls cannot be confirmed. No explicit red-line risk is shown in the supplied material, but the missing evidence requires substantial deductions.
Maintenance 12/20
The repository is not archived and provides an MIT license, version 2.7.0, GitHub source metadata, a CI badge, and indications of Sentry ownership, all of which suggest ongoing maintenance. The material does not provide commit history, release cadence, dependency-update practice, vulnerability-response channel, or maintainer commitments, so a high score is not justified.
Documentation 11/20
The README covers installation methods, runtime requirements, client-connection guidance, CLI examples, skills, telemetry privacy, device signing, and links to further documentation. It does not include the complete tool parameter reference, operational limits, failure cases, cost implications, or the contents of the linked troubleshooting material; README and manifest claims also cannot substitute for reviewable implementation evidence. These gaps reduce the score.
Setup experience 11/20
Homebrew, npm, npx, and global CLI paths are provided, with macOS, Xcode, and Node.js requirements and guidance for mainstream MCP clients. The actual client configuration is delegated to external documentation, and the setup is limited to a macOS/Xcode environment. No source-level end-to-end connection verification or committed test evidence is supplied, so the score remains moderate.

Static review · not runListed 2026-07-29

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesWrites / deletes local filesRuns commands or codeUses the network

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

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

Setup

Before you start

Runtime：Node.js 18+ · Prebuilt binary

Other optional settings (4)
INCREMENTAL_BUILDS_ENABLED optional Boolean to enable experimental xcodemake incremental builds; disabled by default.
XCODEBUILDMCP_ENABLED_WORKFLOWS optional Comma-separated list of workflows to load at startup (e.g. simulator,device,project-discovery); empty loads defaults.
XCODEBUILDMCP_SENTRY_DISABLED optional Boolean to disable the built-in Sentry error telemetry (preferred opt-out flag).
XCODEBUILDMCP_DEBUG optional Boolean to enable verbose debug logging from the server.

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.

Check that it works

Run `xcodebuildmcp --help` to confirm the CLI installed, or launch the server via `npx -y xcodebuildmcp@latest mcp` in your MCP client and check that XcodeBuildMCP tools appear in the client's tool list.

Troubleshooting

  1. Confirm macOS 14.5 or later and Xcode 16.x or later
  2. Confirm Node.js 18+ unless the Homebrew installation is used
  3. Run xcodebuildmcp --help to verify the installation
  4. Check Xcode code-signing configuration when device tools fail
  5. Set XCODEBUILDMCP_DEBUG=true for verbose debug logging
  6. Consult the official installation, configuration, CLI, and troubleshooting documentation

Things to try

Once connected, you can ask your AI assistant things like:

  • Build the MyApp scheme for the simulator using ./MyApp.xcodeproj
  • List the iOS simulators available on my machine
  • Build MyApp for testing and write test products to ./MyApp.xctestproducts
  • Run the prepared test products on the iPhone 17 simulator

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

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 63.3k · Tools 2 Compare with this →
Compare with other MCP servers

Source revision d13ff0c707b0 Data synced 2026-10-19 Read the FMRS scoring method