← Back to all projects

XcodeBuildMCP

Gives a coding agent the Xcode build, simulator and log commands it otherwise has to guess at

MCP serverMIT
Stars
6.5k
Forks
330
Open issues
32
Last commit
27 Oct 2026

What is XcodeBuildMCP?

A coding agent working on an iOS project can write Swift all day and never find out whether it compiles, because the commands that would tell it are long, particular and easy to get subtly wrong. This exposes them properly: build a scheme, boot a simulator, install and launch the app, read the logs, run the tests. Because the agent gets a result it can act on, the loop closes — it fixes the error it just caused instead of handing you a diff to try. It ships as both an MCP server and a plain command-line tool, with optional skills that tell the agent how to use whichever one you installed. It is macOS-only and tracks a current Xcode.

What can you do with XcodeBuildMCP?

  • Let the agent find out whether it compiled — Building a scheme returns real errors and warnings, so the agent corrects its own mistake in the same turn instead of handing you an untested diff.
  • Run the app, not just build it — A simulator can be booted and the app installed and launched, which is the difference between "it compiles" and "it starts".
  • Read the logs it just produced — Runtime logs come back to the agent, so a crash after launch is something it can investigate rather than something you have to relay.
  • Use it as a command or as a server — The same package is an MCP server for agents that speak MCP and a plain CLI for agents that are better at running commands.
  • Tell the agent how to drive it — Optional skills prime the agent with usage guidance, which matters for a tool surface this large — the tools exist, but knowing which to reach for is the hard part.

Before you choose XcodeBuildMCP

  • macOS only, and it tracks a current Xcode and a recent macOS — an older machine kept on a pinned toolchain for a legacy project is exactly the case it does not cover.
  • It gives an agent the ability to build and run code on your machine, so the usual command-approval settings in your client are the boundary — there is no sandbox in this layer.

Star history

29 Aug to 30 Oct · +214

6.3k6.5k

Frequently asked questions

Is XcodeBuildMCP free for commercial use?

XcodeBuildMCP is released under the MIT licence — OSI-approved open source, which permits commercial use.

How can XcodeBuildMCP be deployed?

XcodeBuildMCP is available as Runs locally.