-
securityA
license-
qualityProvides code manipulation, execution, and version control capabilities. It allows AI assistants to read, write, and execute code while maintaining a history of changes.
Last updated -
9
MIT License
Enables creation and management of iOS applications, with support for building, testing, and deploying to iOS simulators.
Supports development of macOS applications with project creation, building capabilities, and management tools.
Facilitates creation and modification of Swift source files within Xcode projects.
Provides programmatic access to Xcode functionality for creating, building, testing, and managing iOS/macOS projects, including project management, file operations, and simulator management.
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
🔧 Configuration
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
🎯 Usage
Once configured, Claude can use these tools directly:
Creating a New Project
Building Projects
Managing Simulators
📚 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
Running in Development
🤝 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 --installfor 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
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
Provides programmatic access to Xcode functionality, enabling AI assistants to create, build, test, and manage iOS/macOS projects directly.
Related MCP Servers
- AsecurityAlicenseAqualityBridges Claude AI with Xcode, enabling AI-powered code assistance, project management, and automated development tasks securely on your local machine.Last updated -12312MIT License
- AsecurityAlicenseAqualityEnables interaction with iOS simulators by providing tools to inspect UI elements, control UI interactions, and manage simulators through natural language commands.Last updated -10769936MIT License
- -securityFlicense-qualityA powerful interface for extending AI capabilities through remote control, calculations, email operations, knowledge search, and more.Last updated -37