MCPgee
MCPgee
MCPgeeMCPgee

XcodeBuildMCP

v2.5.2•Developer Tools•stable

** -  Popular MCP server that enables AI agents to scaffold, build, run and test iOS, macOS, visionOS and watchOS apps or simulators and wired and wireless devices. It has powerful UI-automation capabilities like controlling the simulator, capturing

mcpmcp-servermodel-context-protocolmodel-context-protocol-serverstag-production
Share:
5,702
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is XcodeBuildMCP?

XcodeBuildMCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ** -  popular mcp server that enables ai agents to scaffold, build, run and test ios, macos, visionos and watchos apps or simulators and wired and wireless devices. it has powerful ui-automation capa...

** -  Popular MCP server that enables AI agents to scaffold, build, run and test iOS, macOS, visionOS and watchOS apps or simulators and wired and wireless devices. It has powerful UI-automation capabilities like controlling the simulator, capturing

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • build_dev_proj
  • clean_proj
  • discover_projs
  • get_app_bundle_id
  • get_device_app_path_proj

Use Cases

iOS app development
Simulator control
UI automation testing
getsentry

Maintainer

LicenseMIT License
Languagetypescript
Versionv2.5.2
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

NPM

npx -y xcodebuildmcp

Manual Installation

npx -y xcodebuildmcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use XcodeBuildMCP

XcodeBuildMCP is a popular MCP server from Sentry that enables AI agents to scaffold, build, run, and test iOS, macOS, visionOS, and watchOS applications on both simulators and physical devices — all through natural language via the Model Context Protocol. It exposes over 80 tools covering project discovery, simulator lifecycle, build orchestration, log capture, UI automation, and wireless device deployment, making it the go-to server for AI-assisted Apple platform development. Developers connect it to Claude, Cursor, or Codex to get a hands-on AI pair programmer that can compile their app, tail device logs, take simulator screenshots, and run UI tests without leaving the conversation.

Prerequisites

  • macOS 14.5 (Sonoma) or later
  • Xcode 16.x or later installed from the Mac App Store
  • Node.js 18 or later (if using the npm installation method)
  • An MCP client: Claude Desktop, Claude Code, or Cursor
  • Code signing configured in Xcode (required only for physical device tools)
1

Install XcodeBuildMCP

Install via Homebrew (recommended for automatic updates) or npm. Verify the installation with the --help flag.

# Homebrew (recommended)
brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

# npm
npm install -g xcodebuildmcp@latest

# Verify
xcodebuildmcp --help
2

Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json to add XcodeBuildMCP as an MCP server.

{
  "mcpServers": {
    "xcodebuildmcp": {
      "command": "xcodebuildmcp",
      "args": ["mcp"]
    }
  }
}
3

Add to Claude Code via CLI

Register XcodeBuildMCP with Claude Code at project or user scope.

# User scope (available in all projects)
claude mcp add --scope user xcodebuildmcp -- npx -y xcodebuildmcp@latest mcp

# Or if installed via Homebrew:
claude mcp add --scope user xcodebuildmcp -- xcodebuildmcp mcp
4

Initialise agent skills (optional)

XcodeBuildMCP provides optional agent skill files that prime your AI agent with optimal instructions for using the tools. Run init in your project directory.

# If installed via Homebrew
xcodebuildmcp init

# Or via npx
npx -y xcodebuildmcp@latest init
5

Verify available tools

List all 80+ tools the server exposes to confirm it is installed correctly.

xcodebuildmcp tools
6

Boot a simulator and build your app

The primary one-shot tool is build_run_sim, which builds the scheme, installs the app on a booted simulator, and launches it with log capture in one step.

# Claude will call build_run_sim for you when you ask:
# "Build and run my app on an iPhone 16 simulator"

# Direct CLI equivalent:
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj

XcodeBuildMCP Examples

Client configuration

Claude Desktop configuration for XcodeBuildMCP using the Homebrew-installed binary.

{
  "mcpServers": {
    "xcodebuildmcp": {
      "command": "xcodebuildmcp",
      "args": ["mcp"]
    }
  }
}

// Alternative using npx (no local install needed):
{
  "mcpServers": {
    "xcodebuildmcp": {
      "command": "npx",
      "args": ["-y", "xcodebuildmcp@latest", "mcp"]
    }
  }
}

Prompts to try

With XcodeBuildMCP connected, Claude can control Xcode workflows hands-free.

- "Discover all Xcode projects and schemes in this workspace"
- "Build and run the MyApp scheme on an iPhone 16 Pro simulator and show me the logs"
- "Run the unit tests for the NetworkLayer scheme and report any failures"
- "Take a screenshot of the simulator and describe what is on screen"
- "Install and launch the app on my connected iPhone wirelessly"

Troubleshooting XcodeBuildMCP

build_run_sim fails with 'No matching simulator found'

Ensure at least one iOS simulator is available in Xcode. Open Xcode > Window > Devices and Simulators, and create or boot an iPhone simulator. Then ask Claude to list available simulators (the discover_projs and list simulator tools will show what is available).

Physical device tools fail with code signing errors

Device tools require a valid development team and code signing certificate configured in Xcode. Open your project's Signing & Capabilities settings, select your Apple Developer team, and ensure a provisioning profile is available for your device's UDID.

xcodebuildmcp command not found after Homebrew install

Run `brew link xcodebuildmcp` to ensure the binary is linked to /usr/local/bin (Intel) or /opt/homebrew/bin (Apple Silicon). Add the appropriate Homebrew bin directory to your PATH in ~/.zshrc and reload: `source ~/.zshrc`.

Frequently Asked Questions about XcodeBuildMCP

What is XcodeBuildMCP?

XcodeBuildMCP is a Model Context Protocol (MCP) server that ** -  popular mcp server that enables ai agents to scaffold, build, run and test ios, macos, visionos and watchos apps or simulators and wired and wireless devices. it has powerful ui-automation capabilities like controlling the simulator, capturing It connects AI assistants to external tools and data sources through a standardized interface.

How do I install XcodeBuildMCP?

Install via npm with the command: npx -y xcodebuildmcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with XcodeBuildMCP?

XcodeBuildMCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is XcodeBuildMCP free to use?

Yes, XcodeBuildMCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

XcodeBuildMCP Alternatives — Similar Developer Tools Servers

Looking for alternatives to XcodeBuildMCP? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer ToolsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "xcodebuildmcp": { "command": "npx", "args": ["-y", "xcodebuildmcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use XcodeBuildMCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides