Xcode MCP Server

MCP Server for interacting with Xcode

Local serverstdioPython

What is the Xcode MCP server?

Xcode MCP server exists for a simple reason — assistants are far more useful when they can act on Xcode directly instead of describing what you should do. MCP Server for interacting with Xcode.

What you get

An MCP (Model Context Protocol) server that enables AI assistants to control and interact with Xcode for Apple platform development.

  • Discover and navigate — your Xcode projects and source files
  • Build and run — iOS, macOS, tvOS, and watchOS applications
  • Execute and monitor tests — with detailed results
  • Debug build failures — by retrieving errors and warnings
  • Capture console output — from running applications
  • Take screenshots — of Xcode windows and iOS simulators

Setting it up

The server ships on PyPI as will, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Configuration and credentials

You will need one environment variable: XCODEMCP_ALLOWED_FOLDERS. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • macOS - This server only works on macOS - Xcode - Xcode must be installed - Python 3.10+ - For running the server (uvx will fetch a compatible Python automatically if your system Python is older)

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the xcode mcp server does with a few real requests.

Choosing this one

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. It is maintained by drewster99; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Xcode's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

How to install the Xcode MCP server

{
  "mcpServers": {
    "xcode-mcp-server-drewster99": {
      "command": "uvx",
      "args": ["will"],
      "env": {
        "XCODEMCP_ALLOWED_FOLDERS": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • macOS - This server only works on macOS - Xcode - Xcode must be installed - Python 3.10+ - For running the server (uvx will fetch a compatible Python automatically if your system Python is older)
VariableDescriptionRequired
XCODEMCP_ALLOWED_FOLDERSConfiguration value read at startup.Optional

Frequently asked questions

macOS is required, along with Xcode and Python 3.10+. The `uv` package manager is also needed for installation.