Xcode MCP Server

MCP Server for executing shell commands from MCP clients, particularly useful for Xcode-related operations

Local serverstdio

What is the Xcode MCP Server?

Xcode MCP lets Claude, Cursor and other MCP clients work with Xcode MCP directly. MCP Server for executing shell commands from MCP clients, particularly useful for Xcode-related operations.

What Xcode MCP does

An MCP (Model Context Protocol) server that provides tools for Xcode-related operations, making it easier to work with Xcode projects from MCP clients like Claude Desktop. The server offers various utilities for Xcode project management, building, testing, archiving, code signing, and related iOS development tools.

Key capabilities

  • Xcode project information retrieval and scheme listing
  • Enhanced build capabilities with clean and custom output options
  • Comprehensive test execution with granular control
  • App archiving and IPA export for distribution
  • Code signing and provisioning profile management
  • Swift Package Manager integration
  • iOS Simulator management via simctl
  • NEW: Real Device App Deployment and Launch — with automatic Xcode installation detection and improved device management

Requirements

  • Node.js 16 or higher - npm 6 or higher - Xcode 14 or higher (for all features) - Xcode 16 or higher (required for devicectl and real device features)

Practical notes

  • Maintained by devyhan.

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.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
projectPathrequired): Path to the Xcode project (.xcodeproj) or workspace (.xcworkspace)
schemerequired): The scheme to archive
configurationoptional): Build configuration (e.g., Release)
destinationrequired): Test destination (e.g., 'platform=iOS Simulator,name=iPhone 14')
extraArgsoptional): Additional xcodebuild arguments as array of strings
outputDiroptional): Custom build output directory (SYMROOT)
cleanoptional): Whether to perform clean build (default: false)
testPlanoptional): Name of the test plan to use
onlyTestingoptional): Array of specific test identifiers to run
skipTestingoptional): Array of test identifiers to skip
resultBundlePathoptional): Path to save test result bundle
buildForTestingoptional): Build for testing only without running tests
testWithoutBuildingoptional): Run tests without building
archivePathrequired): Path to save the .xcarchive file
exportPathoptional): Path to export the archive (e.g., IPA file)
exportOptionsPlistoptional): Path to the exportOptions.plist file

How to install the Xcode MCP Server

{
  "mcpServers": {
    "xcode-mcp": {
      "command": "npx",
      "args": [
        "@devyhan/xcode-mcp",
        "-y"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js 16 or higher - npm 6 or higher - Xcode 14 or higher (for all features) - Xcode 16 or higher (required for devicectl and real device features)

Example prompts to try

  • “Use Xcode MCP to Requirements.”

Frequently asked questions

MCP Server for executing shell commands from MCP clients, particularly useful for Xcode-related operations Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.