xcodebuildmcp

Build and test Xcode projects via a local CLI wrapping XcodeBuildMCP.

122|16|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/w-winter/dot314 --skill xcodebuildmcp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xcodebuildmcp
Source: https://github.com/w-winter/dot314/tree/main/skills/xcodebuildmcp
Command: npx skills add https://github.com/w-winter/dot314 --skill xcodebuildmcp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander, mcporter.

What problem does it solve?

This skill provides a local CLI wrapper around the XcodeBuildMCP server, enabling automated build and test workflows for Xcode projects without integrating MCP directly into agent prompts.

Core Features & Use Cases

  • Rich MCP-driven tooling exposed as a local CLI to drive macOS/iOS build and test tasks from pi agent workflows.
  • Supports generation and regeneration of the CLI from embedded MCP metadata, ensuring tools stay in sync with the MCP server definitions.
  • Includes commands for common Xcode operations such as building, cleaning, discovering projects, and interacting with simulators and devices.
  • Use Case: Integrate iOS/macOS project builds into a CI/automation pipeline that triggers on code changes and reports results back to the agent.

Quick Start

  1. Navigate to the skill directory and install dependencies: cd {baseDir} && npm install
  2. Inspect available commands: {baseDir}/xcodebuildmcp.sh --help
  3. Regenerate the CLI if MCP tools change: cd {baseDir} && npx mcporter generate-cli --from ./xcodebuildmcp.ts

Frequently Asked Questions about xcodebuildmcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Xcode project builds and tests from a CLI?

Automating Xcode builds from a CLI involves using a local wrapper around the XcodeBuildMCP server, which exposes commands like build-device and clean to drive iOS and macOS workflows without embedding MCP directly into agent prompts.

Can I integrate iOS build tasks into an existing automation pipeline?

Yes, you can integrate iOS build tasks into an automation pipeline by invoking the local CLI through JSON-based commands, allowing triggers on code changes to report build and test results directly back to the agent workflow.

Do I need to install dependencies before running xcodebuildmcp?

Yes, you need to install dependencies by navigating to the skill directory and running npm install before inspecting available commands or regenerating the CLI from embedded MCP metadata.

What Xcode operations are supported by the MCP-driven CLI?

The MCP-driven CLI supports common Xcode operations including building, cleaning, discovering projects, and interacting with simulators and devices to streamline macOS and iOS development tasks.

How do I regenerate the CLI when MCP tools change?

To regenerate the CLI when MCP tools change, navigate to the base directory and run npx mcporter generate-cli --from ./xcodebuildmcp.ts to ensure the CLI stays in sync with MCP server definitions.

What is the best way to keep CLI tools in sync with XcodeBuildMCP server definitions?

The best way to keep CLI tools in sync with XcodeBuildMCP server definitions is to generate and regenerate the local CLI directly from embedded MCP metadata, ensuring all tool definitions match the server.