Skip to content
XcodeBuildMCP logo

XcodeBuildMCP

Verified

MCP server and CLI for Xcode-based iOS and macOS development.

MCP ServerAI & KnowledgeLocal (stdio) 5.9k
View on GitHub
Updated 2026-06-15

What is the XcodeBuildMCP MCP server?

XcodeBuildMCP provides build, simulator, and device tooling for Xcode 16 projects on macOS 14.5+. It supports both MCP mode for agents and a unified CLI that can launch a stateful daemon for logging and debugging.

Optional agent skills can be installed to prime models on effective use of the tools or CLI commands. The server is distributed via Homebrew or npm and requires no remote API keys.

Install & connect

Add this to your MCP client config. Pick your client below and copy.

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

Package: xcodebuildmcp (npm)

Other ways to install

npx

npx
npx -y xcodebuildmcp

Example prompts

Once connected, try asking your AI client:

Build the MyApp scheme for the iOS simulator using the local Xcode project.
List all available tools provided by the XcodeBuildMCP server.
Start a debug session on a connected device after building the latest changes.
Show the current CLI commands and their options.

Security & permissions

Runs locally via stdio on macOS and accesses Xcode projects, build artifacts, and optionally device signing identities; no remote API keys required.

What you can do with XcodeBuildMCP

Simulator builds

Trigger simulator builds for a given scheme and project path directly from an AI coding session.

Device deployment

Run and debug apps on physical devices after code signing is configured in Xcode.

Log capture

Start stateful log capture sessions for troubleshooting builds or runtime issues.

How to use XcodeBuildMCP

  1. 1Install via Homebrew or npm (Node 18+).
  2. 2Run xcodebuildmcp mcp to start the server for MCP clients.
  3. 3Add the stdio configuration to your AI client (Cursor, Claude, etc.).
  4. 4Optionally run xcodebuildmcp init to install agent skills.
  5. 5Use xcodebuildmcp tools or CLI subcommands for direct access.

XcodeBuildMCP: pros & cons

Pros

  • +Native Xcode 16 and macOS integration with simulator and device support.
  • +Dual CLI + MCP interface with stateful daemon for logs and debugging.
  • +Agent skills available to improve model performance on Apple projects.
  • +Simple install via Homebrew or npm with no external service dependencies.

Cons

  • Requires recent macOS and Xcode versions; not usable on other platforms.
  • Device features need manual code-signing setup in Xcode.
  • Tool list is not documented in public README; must query via CLI.
Did you find this helpful?

Frequently asked questions

Yes, clients can invoke it on demand with npx -y xcodebuildmcp@latest mcp.

User reviews

Verified reviews from the community shape this listing's rating.

Loading reviews…

Sign in to review

Promote XcodeBuildMCP

Add this badge to your website, or share the tool.

DFeatured on DhanasviXcodeBuildMCP 1