How do I restrict which folders the server can access?

Set the `XCODEMCP_ALLOWED_FOLDERS` environment variable to a colon-separated list of absolute directory paths. If unset, the server defaults to your home directory.

What can the server do for me?

It allows AI assistants to discover projects, build and run apps, execute tests, debug build failures, capture console output and screenshots, and manage simulators.

What credentials does it need?

It reads `XCODEMCP_ALLOWED_FOLDERS` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Xcode MCP Server

MCP Server for interacting with Xcode

Local serverstdioPython

What is the Xcode MCP Server?

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

Configuration and credentials

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)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

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)