Xcode MCP (Model Context Protocol) Server

MCP server for Xcode - enables AI assistants to create, build, test, and manage iOS/macOS projects programmatically

typescript

5

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ebowwa-xcode-mcp": {
      "command": "node",
      "args": [
        "/path/to/xcode-mcp/dist/index.js"
      ]
    }
  }
}

You gain a Node-based MCP server that exposes programmatic access to Xcode functionality, enabling you to create, build, test, archive, and manage iOS/macOS projects and simulators from your preferred MCP client.

How to use

You connect to the MCP server from your MCP client and invoke dedicated tools to manage Xcode projects and simulators. The server exposes endpoints that let you create projects, generate files, modify configuration files, build and test apps, manage simulators, install and launch apps, and capture screenshots from running simulators. Use clear, imperative commands in your client to request these actions and handle responses in your workflow.

How to install

Prerequisites you need before installing include Node.js, Xcode with command line tools, and macOS.

Step 1: Clone the MCP server repository

git clone https://github.com/yourusername/xcode-mcp.git
cd xcode-mcp

Step 2: Install dependencies and build the project

npm install
npm run build

Step 3: Run the server in development mode (if applicable)

npm run dev

Step 4: Configure your Claude Desktop or MCP client to connect to the server. The server can run locally via the MCP bootstrap configuration shown below.

Configuration

{
  "mcpServers": {
    "xcode_mcp": {
      "command": "node",
      "args": ["/path/to/xcode-mcp/dist/index.js"],
      "env": {}
    }
  }
}

Available tools

xcode_create_project

Create new Xcode projects with templates to generate complete project structures.

xcode_create_swift_file

Write Swift source files to the filesystem within the project.

xcode_build_project

Build Xcode projects with configurable configurations.

xcode_test_project

Run unit and UI tests for the Xcode project.

xcode_archive_project

Archive the app for distribution.

xcode_list_simulators

List available iOS, watchOS, and tvOS simulators.

xcode_boot_simulator

Start (boot) a chosen simulator.

xcode_install_app_simulator

Install an app onto a simulator.

xcode_modify_plist

Modify Info.plist values programmatically.

xcode_show_build_settings

Display build configurations and settings.