← Back to directory
X

Xcodebuild MCP Server

Community
MCP tool for building Xcode iOS projects and feeding back errors to LLMs
GitHub source repository ↗
★ 84 Stars Category · Dev Tools Popular Source revision 543536b2e405
41FMRS · D
Reliability
5/20
Security and permissions
10/20
Maintenance
8/20
Documentation
10/20
Setup experience
8/20

This MCP server focuses on building and testing iOS projects, providing a simple tool interface to feed build errors back to LLMs. It suits integration with AI coding assistants but is limited in functionality to build and test only.

Read the FMRS scoring method →

The xcodebuild MCP Server is a Model Context Protocol server that builds iOS workspaces/projects, enabling seamless workflow with iOS projects in Visual Studio Code using extensions like Cline or Roo Code. It provides two tools for building and testing, and can feed back errors to LLMs for AI-assisted development.

Tools

build
Build iOS Xcode workspace/project. Parameters: folder (string, required): The full path of the current folder that the iOS Xcode workspace/project sits.
test
Run tests for iOS Xcode workspace/project. Parameters: folder (string, required): The full path of the current folder that the iOS Xcode workspace/project sits.

Setup

Recommended using uv: no specific installation needed; run mcpxcodebuild directly via uvx. Alternatively, install via pip: pip install mcpxcodebuild, then run python -m mcpxcodebuild.

claude_desktop_config.json
{
  "mcpServers": {
    "mcpxcodebuild": {
      "command": "uvx",
      "args": ["mcpxcodebuild"]
    }
  }
}

Fit and risk

Best for

  • iOS developers using Visual Studio Code with AI extensions (e.g., Cline, Roo Code)
  • AI coding workflows that require quick build and test of iOS projects

Not for

  • Users needing a GUI-based build tool
  • Users not working with Xcode or iOS development
  • Those requiring advanced build configurations (e.g., signing, certificate management)

Required permissions

  • Reads the full path of the specified folder
  • Executes xcodebuild commands to build or test the project

Risks and side effects

  • Builds may take a long time; ensure appropriate timeout settings
  • Builds may consume significant CPU and memory
  • Incorrect project paths may cause build failures

Troubleshooting

  1. Ensure the folder parameter provides the correct project path. Verify that Xcode and command-line tools are installed. If using pip, confirm the Python environment is correct.

Use cases

Building and testing iOS projects within Cline or Roo Code
Feeding build errors back to LLMs for automated fixes
Integrating iOS build verification into AI-assisted coding workflows

Supported clients

Claude DesktopFull support
ClinePartial support
Roo CodePartial support