Xcode MCP Server
Enables the building and management of iOS applications by interfacing with Xcode project structures and build tools.
Facilitates interaction with macOS-based Xcode development environments to manage projects and trigger system-level builds.
Provides tools for interacting with Xcode projects, allowing AI agents to list projects, inspect targets and schemes, and execute builds.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Xcode MCP Server build the MyApp scheme for iPhone 15 simulator"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π¨ Xcode MCP Server
The first MCP server for Xcode β Let AI agents like Claude build your iOS apps!
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 |
| Find all Xcode projects in a directory tree |
| Parse .xcodeproj structure (targets, configs, files) |
| Get build targets with product types |
| List available build schemes |
| Trigger xcodebuild with configurable options |
| 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 buildConfiguration
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
.xcodeprojfiles directly (simplified parser).xcworkspacesupport coming soonBuild output truncated to last 5KB for large projects
Code signing disabled by default for faster builds
πΊοΈ Roadmap
Workspace (
.xcworkspace) supportSimulator 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 toolsbuildC
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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
Cloud iPhones and Macs with Xcode for AI agents: build, run and test iOS apps, use the screen.
The cloud Mac alone, with Xcode, for AI agents: run commands, build and test, use the screen.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yoβ¦
A Model Context Protocol (MCP) application for automated GitHub PR analysis and issue management.β¦
Related MCP Servers
- AlicenseBqualityDmaintenanceA 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.1853ISC
- AlicenseBqualityDmaintenanceProvides programmatic access to Xcode functionality, enabling AI assistants to create, build, test, and manage iOS/macOS projects directly.335MIT
- AlicenseBqualityDmaintenanceEnables 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.57 npm2MIT
- AlicenseNot gradedqualityCmaintenanceBridges AI assistants with Xcode to control projects, builds, simulators, testing, and debugging without manual interaction.1MIT