Skip to main content
Glama

Xcode MCP Server

by ebowwa
npmGitHub
TypeScript
MIT License
43
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

ToolDescription
xcode_create_projectCreate new Xcode projects with templates
xcode_create_swift_fileWrite Swift source files
xcode_build_projectBuild Xcode projects
xcode_test_projectRun project tests
xcode_list_simulatorsList available simulators
xcode_boot_simulatorStart a simulator
xcode_install_app_simulatorInstall apps on simulators
xcode_modify_plistModify plist files
xcode_show_build_settingsDisplay build configurations
xcode_archive_projectCreate 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

📞 Support

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Provides programmatic access to Xcode functionality, enabling AI assistants to create, build, test, and manage iOS/macOS projects directly.

  1. 🚀 Features
    1. Project Management
    2. File Operations
    3. Simulator Management
  2. 📦 Installation
    1. 🔧 Configuration
      1. 🎯 Usage
        1. Creating a New Project
        2. Building Projects
        3. Managing Simulators
      2. 📚 Available Tools
        1. 🛠️ Development
          1. Prerequisites
          2. Building from Source
          3. Running in Development
        2. 🤝 Contributing
          1. 📋 Requirements
            1. 🐛 Troubleshooting
              1. Common Issues
            2. 📄 License
              1. 🙏 Acknowledgments
                1. 📞 Support

                  Related MCP Servers

                  • CodeSavant

                    twolven
                    -
                    security
                    A
                    license
                    -
                    quality
                    Provides 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 -
                    8
                    Python
                    MIT License

                  • Xcode MCP Server

                    r-huijts
                    A
                    security
                    A
                    license
                    A
                    quality
                    Bridges Claude AI with Xcode, enabling AI-powered code assistance, project management, and automated development tasks securely on your local machine.
                    Last updated -
                    9
                    43
                    291
                    TypeScript
                    MIT License
                    • Apple

                  • iOS Simulator MCP

                    joshuayoes
                    A
                    security
                    A
                    license
                    A
                    quality
                    Enables interaction with iOS simulators by providing tools to inspect UI elements, control UI interactions, and manage simulators through natural language commands.
                    Last updated -
                    6
                    673
                    779
                    JavaScript
                    MIT License
                    • Apple

                  • XiaoZhi MCP Aggregate

                    avxxoo
                    -
                    security
                    F
                    license
                    -
                    quality
                    A powerful interface for extending AI capabilities through remote control, calculations, email operations, knowledge search, and more.
                    Last updated -
                    34
                    Python

                  View all related MCP servers

                  New MCP Servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/ebowwa/xcode-mcp'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server