Skip to content

GETTING_STARTED.md

Latest commit

 

History

History
73 lines (54 loc) · 2.76 KB

GETTING_STARTED.md

File metadata and controls

73 lines (54 loc) · 2.76 KB

Getting Started

Prerequisites

  • macOS 14.5 or later
  • Xcode 16.x or later
  • Node.js 18.x or later

Install options

Smithery (recommended)

npx -y @smithery/cli@latest install cameroncooke/xcodebuildmcp --client client-name

One click install

If you are using Cursor or VS Code you can use the quick install links below.

Install MCP Server

Install in VS Code

Install in VS Code Insiders

Manual installation

Most MCP clients use JSON configuration. Add the following to your client configuration under mcpServers:

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

Client-specific configuration

OpenAI Codex CLI

Codex uses TOML for MCP configuration. Add this to your Codex CLI config file:

[mcp_servers.XcodeBuildMCP]
command = "npx"
args = ["-y", "xcodebuildmcp@latest"]
env = { "INCREMENTAL_BUILDS_ENABLED" = "false", "XCODEBUILDMCP_SENTRY_DISABLED" = "false" }

If you see tool calls timing out (for example, timed out awaiting tools/call after 60s), increase the timeout:

tool_timeout_sec = 600

For more info see the OpenAI Codex configuration docs: https://github.com/openai/codex/blob/main/docs/config.md#connecting-to-mcp-servers

Claude Code CLI

# Add XcodeBuildMCP server to Claude Code
claude mcp add XcodeBuildMCP npx xcodebuildmcp@latest

# Or with environment variables
claude mcp add XcodeBuildMCP npx xcodebuildmcp@latest -e INCREMENTAL_BUILDS_ENABLED=false -e XCODEBUILDMCP_SENTRY_DISABLED=false

Note: XcodeBuildMCP requests xcodebuild to skip macro validation to avoid Swift Macro build errors.

Next steps