Xcode MCP Server

@drewster99

Repository

Basic information

About Xcode MCP Server

MCP Server for interacting with Xcode

#xcode #developer#tool

Xcode MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "xcode-mcp-server": {
      "command": "uvx",
      "args": [
        "xcode-mcp-server"
      ]
    }
  }
}

Xcode MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Xcode MCP Server?

Xcode MCP Server is an MCP (Model Context Protocol) server that enables AI assistants to control and interact with Xcode for Apple platform development. It is built for macOS and requires Xcode and Python 3.10+.

How to use Xcode MCP Server?

Install via uv and configure in your MCP client (Claude Code, Claude Desktop, or Cursor) using the provided JSON commands. Security is managed via the XCODEMCP_ALLOWED_FOLDERS environment variable to restrict which directories the server can access.

Key features of Xcode MCP Server

Discover and navigate 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 and take screenshots
Manage simulators and view their status

Use cases of Xcode MCP Server

Have an AI assistant find and build your Xcode project
Automate test execution and failure reporting
Troubleshoot build errors without leaving the AI chat
Run and capture simulator or Xcode window screenshots
Manage simulator devices programmatically

Frequently asked questions

What are the system requirements?

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

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.

How do I set it up with Claude Desktop?

Add an entry to `~/Library/Application Support/Claude/claude_desktop_config.json` with the command `uvx` and argument `xcode-mcp-server`. You can optionally add an `env` section for folder restrictions.

What are the known limitations?

AppleScript syntax may need adjustments for specific Xcode versions, and some operations require the project to be open in Xcode first.

Comments

More Other MCP servers

Courio

Benoit

Mail a real postal letter worldwide from a PDF or text. No account, pay per letter.

LoadOptimizer

LoadOptimizer plans truck, container and pallet loads with a real optimization engine, straight from your AI assistant. Describe the order in plain language, for example "plan 36 Euro pallets on a standard 13.6 m trailer

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40