From 512d16cba96db60b0cb8852808c2adf2de3f5ab1 Mon Sep 17 00:00:00 2001 From: Cameron Cooke Date: Tue, 3 Feb 2026 18:19:59 +0000 Subject: [PATCH 1/3] Fix incorrect install link --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a7e6a6c6..3d6b5e42 100644 --- a/README.md +++ b/README.md @@ -112,7 +112,7 @@ Add XcodeBuildMCP to your MCP client configuration. Most clients use JSON config Or use the quick install links: - [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/en-US/install-mcp?name=XcodeBuildMCP&config=eyJjb21tYW5kIjoibnB4IC15IHhjb2RlYnVpbGRtY3BAYmV0YSBtY3AifQ%3D%3D) + [![Install in VS Code](https://img.shields.io/badge/VS_Code-XcodeBuildMCP-0098FF?style=flat&logo=visualstudiocode&logoColor=ffffff)](vscode:mcp/install?%7B%22name%22%3A%22XcodeBuildMCP%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22xcodebuildmcp%40beta%22%2C%22mcp%22%5D%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-XcodeBuildMCP-24bfa5?style=flat&logo=visualstudiocode&logoColor=ffffff)](vscode-insiders:mcp/install?%7B%22name%22%3A%22XcodeBuildMCP%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22xcodebuildmcp%40beta%22%2C%22mcp%22%5D%7D)
From 164e2d2acdb378d08b59fc087a6cf3b79bea3f0b Mon Sep 17 00:00:00 2001 From: Cameron Cooke Date: Wed, 4 Feb 2026 15:48:11 +0000 Subject: [PATCH 2/3] Update README for Xcode MCP config --- README.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) diff --git a/README.md b/README.md index 3d6b5e42..4fd89d8b 100644 --- a/README.md +++ b/README.md @@ -153,6 +153,61 @@ Add XcodeBuildMCP to your MCP client configuration. Most clients use JSON config
+
+ Xcode (Codex Agent) +
+ + Requires Xcode 26.3 or later. Codex agent must be installed and configured in Xcode Settings -> Intelligence -> Open AI. + + The only way at the time of writing to add an MCP server is to use a project scoped `.codex/config.toml` file in the root of your project workspace: + `/path/to/your/project/.codex/config.toml` + + ```toml + [mcp_servers.XcodeBuildMCP] + args = [ + "-lc", + "PATH=/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin; export NVM_DIR=\"$HOME/.nvm\"; [ -s \"$NVM_DIR/nvm.sh\" ] && . \"$NVM_DIR/nvm.sh\"; nvm use --silent >/dev/null 2>&1 || true; npx -y xcodebuildmcp@beta mcp" + ] + command = "/bin/zsh" + enabled = true + tool_timeout_sec = 10000 + ``` + + > [!NOTE] + > Codex Agent when running in Xcode has a limted PATH by default. The above example should work for most users but if you find the server doesn't start or is not available, it's likely because npx is not found so you might have to adjust the above configuration accordingly. + +
+
+ +
+ Xcode (Claude Code Agent) +
+ + Requires Xcode 26.3 or later. Claude Code agent must be installed and configured in Xcode Settings -> Intelligence -> Anthropic. + + Add to the end or replace the existing `mcpServers` object in Xcode's Claude Code agent config at: + `~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/.claude.json` + + ```json + # rest of file... + "mcpServers": { + "XcodeBuildMCP": { + "command": "/bin/zsh", + "args": [ + "-lc", + "PATH=/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin; export NVM_DIR=\"$HOME/.nvm\"; [ -s \"$NVM_DIR/nvm.sh\" ] && . \"$NVM_DIR/nvm.sh\"; nvm use --silent >/dev/null 2>&1 || true; npx -y xcodebuildmcp@beta mcp" + ] + } + } + } + ``` + + > [!NOTE] + > Claude Code Agent when running in Xcode has a limted PATH by default. The above example should work for most users but if you find the server doesn't start or is not available, it's likely because npx is not found so you might have to adjust the above configuration accordingly. + +
+
+
For other installation options see [Getting Started](docs/GETTING_STARTED.md) From 087a6b96eedf37a894ea98840d9779acfd234f58 Mon Sep 17 00:00:00 2001 From: Cameron Cooke Date: Wed, 4 Feb 2026 15:55:41 +0000 Subject: [PATCH 3/3] Fix README issues --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 4fd89d8b..41512a8f 100644 --- a/README.md +++ b/README.md @@ -174,7 +174,7 @@ Add XcodeBuildMCP to your MCP client configuration. Most clients use JSON config ``` > [!NOTE] - > Codex Agent when running in Xcode has a limted PATH by default. The above example should work for most users but if you find the server doesn't start or is not available, it's likely because npx is not found so you might have to adjust the above configuration accordingly. + > Codex Agent when running in Xcode has a limited PATH by default. The above example should work for most users but if you find the server doesn't start or is not available, it's likely because npx is not found so you might have to adjust the above configuration accordingly.
@@ -189,7 +189,7 @@ Add XcodeBuildMCP to your MCP client configuration. Most clients use JSON config `~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/.claude.json` ```json - # rest of file... + // ... rest of file ... "mcpServers": { "XcodeBuildMCP": { "command": "/bin/zsh", @@ -203,7 +203,7 @@ Add XcodeBuildMCP to your MCP client configuration. Most clients use JSON config ``` > [!NOTE] - > Claude Code Agent when running in Xcode has a limted PATH by default. The above example should work for most users but if you find the server doesn't start or is not available, it's likely because npx is not found so you might have to adjust the above configuration accordingly. + > Claude Code Agent when running in Xcode has a limited PATH by default. The above example should work for most users but if you find the server doesn't start or is not available, it's likely because npx is not found so you might have to adjust the above configuration accordingly.