MCP Directory

How to add XcodeBuildMCP to Cursor

Build, run, and debug iOS & macOS apps in Xcode from your AI coding agent. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 6.0k★ · stdio · no auth

Cursor config for XcodeBuildMCP

npm install -g xcodebuildmcp@latest
{
  "mcpServers": {
    "xcodebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp@latest",
        "mcp"
      ]
    }
  }
}

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the XcodeBuildMCP config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of XcodeBuildMCP's tools to confirm it's connected.

Before you start

  • macOS 14.5 or later
  • Xcode 16.x or later
  • Node.js 18.x or later (not required for the Homebrew installation)
  • Code signing configured in Xcode for device-targeting tools

What XcodeBuildMCP can do in Cursor

list_schemes

Discover valid build schemes for a project or workspace.

build_run_sim

Build the scheme, install the resulting .app on a booted simulator, and launch it, capturing logs to a file.

build_run_device

Build, install, and launch the app on a connected physical device.

build_run_macos

Build, install, and launch a macOS app.

launch_app_sim

Launch an already-installed app on a booted simulator.

launch_app_device

Launch an already-installed app on a connected physical device.

launch_mac_app

Launch a built macOS app.

Security

XcodeBuildMCP uses Sentry for internal runtime error telemetry only; see the project's Privacy & Telemetry docs for details and opt-out instructions. Device tools require code signing to be configured in Xcode.

XcodeBuildMCP + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the XcodeBuildMCP config there under the "mcpServers" key and restart the client.

Is XcodeBuildMCP safe to use with Cursor?

XcodeBuildMCP uses Sentry for internal runtime error telemetry only; see the project's Privacy & Telemetry docs for details and opt-out instructions. Device tools require code signing to be configured in Xcode.

Does it support both iOS and macOS projects?

Yes. It provides tools for iOS simulators, physical iOS devices, and macOS apps.

Do I need to install it globally?

No. While you can install globally via Homebrew or npm, most MCP clients can run the server on demand with `npx -y xcodebuildmcp@latest mcp` without a global install.

Does it send any telemetry?

It uses Sentry for internal runtime error telemetry only. The project documents how to opt out in its Privacy & Telemetry page.

View repo Full XcodeBuildMCP page