Skip to main content
Glama

πŸ”¨ Xcode MCP Server

The first MCP server for Xcode β€” Let AI agents like Claude build your iOS apps!

License: MIT MCP Platform

An MCP (Model Context Protocol) server that gives AI assistants the power to work with Xcode projects. List projects, read configurations, inspect targets, and trigger builds β€” all through natural conversation.

✨ Features

Tool

Description

list-projects

Find all Xcode projects in a directory tree

read-project

Parse .xcodeproj structure (targets, configs, files)

list-targets

Get build targets with product types

list-schemes

List available build schemes

build

Trigger xcodebuild with configurable options

xcodebuild-info

Get Xcode version and available SDKs

Related MCP server: Xcode MCP Server

πŸš€ Quick Start

Prerequisites

  • macOS with Xcode Command Line Tools (xcode-select --install)

  • Node.js 18+

  • npm or yarn

Installation

# Clone the repo
git clone https://github.com/airdrop-alpha/xcode-mcp.git
cd xcode-mcp

# Install dependencies
npm install

# Build TypeScript
npm run build

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

OpenClaw

Add to your OpenClaw MCP config:

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

πŸ’¬ Example Conversation

You: List Xcode projects in my Developer folder

Claude: Found 3 Xcode projects:
  β€’ MyApp.xcodeproj
  β€’ TestFramework.xcodeproj
  β€’ SampleProject.xcodeproj

You: What targets does MyApp have?

Claude: MyApp has 3 targets:
  β€’ MyApp (application)
  β€’ MyAppTests (unit-test)
  β€’ MyAppUITests (ui-test)

You: Build it for iPhone 15 simulator

Claude: βœ… Build succeeded!

πŸ› οΈ Tool Reference

list-projects

Find Xcode projects in a directory (recursive, 5 levels deep).

{ "directory": "/path/to/search" }

read-project

Parse an Xcode project file and return its structure.

{ "projectPath": "/path/to/MyApp.xcodeproj" }

Returns: Project name, targets, build configurations, source files.

list-targets

List build targets with their product types.

{ "projectPath": "/path/to/MyApp.xcodeproj" }

Returns: Target names and types (app, framework, test, etc.)

list-schemes

List available schemes (shared and user).

{ "projectPath": "/path/to/MyApp.xcodeproj" }

build

Build a project using xcodebuild.

{
  "projectPath": "/path/to/MyApp.xcodeproj",
  "scheme": "MyApp",
  "configuration": "Debug",
  "destination": "platform=iOS Simulator,name=iPhone 15",
  "clean": false
}

xcodebuild-info

Get Xcode version and SDK information. No parameters required.

πŸ—οΈ Architecture

xcode-mcp/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ index.ts         # MCP server entry point
β”‚   └── xcode-parser.ts  # Xcode project file parser
β”œβ”€β”€ dist/                # Compiled JavaScript
β”œβ”€β”€ package.json
β”œβ”€β”€ tsconfig.json
└── README.md

⚠️ Current Limitations

  • Parses .xcodeproj files directly (simplified parser)

  • .xcworkspace support coming soon

  • Build output truncated to last 5KB for large projects

  • Code signing disabled by default for faster builds

πŸ—ΊοΈ Roadmap

  • Workspace (.xcworkspace) support

  • Simulator management (list, boot, install)

  • Test execution with result parsing

  • Swift Package dependencies

  • Provisioning profile management

  • App Store Connect integration

🀝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md first.

# Development mode (hot reload)
npm run dev

# Test with MCP Inspector
npm run inspect

πŸ“„ License

MIT Β© 2026


Built for the AI-assisted development era. πŸ€–

Available Tools

6 tools
buildC

Build an Xcode project using xcodebuild. Can specify target, scheme, configuration, and destination.

Inputs: projectPath (required), scheme, target, configuration, +2 more.

list-projectsA

Find all Xcode projects (.xcodeproj) in a directory. Searches recursively up to 5 levels deep, excluding common build directories.

Inputs: directory.

list-schemesB

List all schemes available in an Xcode project (both shared and user schemes)

Inputs: projectPath (required).

list-targetsB

List all build targets in an Xcode project with their product types (app, framework, test, etc.)

Inputs: projectPath (required).

read-projectB

Read and parse an Xcode project file (.xcodeproj). Returns project structure including targets, build configurations, and source files.

Inputs: projectPath (required).

xcodebuild-infoB

Get xcodebuild version and available SDKs information

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: building projects, listing projects/schemes/targets, reading project details, and getting xcodebuild info. The descriptions reinforce these distinct roles, making misselection unlikely.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern (list-projects, list-schemes, list-targets, read-project), but 'build' and 'xcodebuild-info' deviate slightly. The naming is still readable and predictable overall, with only minor inconsistencies.

    Tool Count5/5

    Six tools is well-scoped for an Xcode server, covering essential operations like building, listing, reading, and getting system info. Each tool earns its place without feeling excessive or insufficient for the domain.

    Completeness4/5

    The toolset covers core Xcode workflows well, including discovery, inspection, and building. Minor gaps exist, such as no explicit tools for running tests or managing dependencies, but agents can likely work around these with the provided tools.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI assistants to build and test Xcode projects directly through a standardized interface, with capabilities for running tests, monitoring progress, and accessing logs in real-time.
      18
      53
      ISC
    • A
      license
      B
      quality
      D
      maintenance
      Provides programmatic access to Xcode functionality, enabling AI assistants to create, build, test, and manage iOS/macOS projects directly.
      33
      5
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to build, test, run, and manage Apple platform projects (iOS, macOS, tvOS, watchOS, visionOS) directly through Xcode. Provides comprehensive control over Xcode projects, Swift packages, simulators, and development workflows without leaving your editor.
      5
      7 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Bridges AI assistants with Xcode to control projects, builds, simulators, testing, and debugging without manual interaction.
      1
      MIT