Xcode MCP (Model Context Protocol) Server

A comprehensive MCP server that provides programmatic access to Xcode functionality, enabling AI assistants like Claude to create, build, test, and manage iOS/macOS projects directly.

🚀 Features

Project Management

Create new Xcode projects - Generate complete project structures with SwiftUI templates
Build projects - Compile apps with customizable configurations
Run tests - Execute unit and UI tests
Archive apps - Create archives for distribution
Manage schemes - List and work with project schemes

File Operations

Create Swift files - Write source code directly to the filesystem
Modify Info.plist - Update app configurations programmatically
Create directories - Set up project folder structures
Read files - Access and analyze existing code

Simulator Management

List simulators - View all available iOS, watchOS, and tvOS simulators
Boot/shutdown simulators - Control simulator lifecycle
Install apps - Deploy apps to simulators
Launch apps - Run apps with specific bundle IDs
Capture screenshots - Take simulator screenshots programmatically

📦 Installation

# Clone the repository
git clone https://github.com/yourusername/xcode-mcp.git
cd xcode-mcp

# Install dependencies
npm install

# Build the project
npm run build

🔧 Configuration

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

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

🎯 Usage

Once configured, Claude can use these tools directly:

Creating a New Project

User: "Create a new iOS app called MyApp"
Claude: *uses xcode_create_project to generate the project structure*

Building Projects

User: "Build my iOS app"
Claude: *uses xcode_build_project with appropriate parameters*

Managing Simulators

User: "Show me available simulators"
Claude: *uses xcode_list_simulators to display options*

📚 Available Tools

Tool	Description
`xcode_create_project`	Create new Xcode projects with templates
`xcode_create_swift_file`	Write Swift source files
`xcode_build_project`	Build Xcode projects
`xcode_test_project`	Run project tests
`xcode_list_simulators`	List available simulators
`xcode_boot_simulator`	Start a simulator
`xcode_install_app_simulator`	Install apps on simulators
`xcode_modify_plist`	Modify plist files
`xcode_show_build_settings`	Display build configurations
`xcode_archive_project`	Create app archives

🛠️ Development

Prerequisites

Node.js 16+
Xcode 14+
macOS 12+

Building from Source

npm install
npm run build

Running in Development

npm run dev

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📋 Requirements

macOS: Required for Xcode integration
Xcode: Must be installed with command line tools
Node.js: Version 16 or higher

🐛 Troubleshooting

Common Issues

Simulators not showing:

Ensure Xcode is properly installed
Run xcode-select --install for command line tools

Build failures:

Check Xcode project paths are correct
Verify scheme names match exactly

MCP connection errors:

Restart Claude Desktop after configuration changes
Check logs at ~/Library/Logs/Claude/mcp-server-xcode-mcp.log

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Built on the Model Context Protocol by Anthropic
Uses Apple's Xcode command line tools

📞 Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Wiki: Documentation Wiki

Xcode MCP Server

README Documentation