The xcode-mcp-server plugin: build and test in Xcode

xcode-mcp-server bundles an MCP server that lets Claude Code build Xcode projects and run tests, returning structured JSON output and persisting logs - so you can iterate on a Swift or Apple project and have Claude read the results directly.

Install

claude plugin install xcode-mcp-server@robworks-claude-code-plugins

First-run setup

There’s no setup command - once installed and Claude Code is restarted, the MCP tools are available. It drives your local Xcode toolchain, so Xcode and its command-line tools must be installed.

What you can do

Two core tools:

  • build_project - build a project or scheme and return structured results (errors, warnings, timing).
  • run_tests - run a test target and return pass/fail with details.

Because output is structured JSON with persisted logs, Claude can pinpoint the failing file and line rather than scrolling raw build output.

Good to know

  • macOS with Xcode installed is required.
  • Point it at a real project or scheme; large builds can take a while, and the first build after a clean is slowest.
  • For long silent builds, running the build step yourself and sharing the result is sometimes faster than waiting on a single long call.

Getting help

Repo and issues: github.com/ringo380/Xcode-mcp-server. Build not working? Send us a message and a human will reply by email.

Still need help? Contact us

The xcode-mcp-server plugin: build and test in Xcode - Robworks Software