MobileBuildMCP MCP server

Q: How do I add MobileBuildMCP MCP to Claude Code?

Run `claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add MobileBuildMCP MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

✓ Official ✓ VerifiedCommit Nov 13, 2026

getsentry/mobilebuildmcp · typescript · MIT

Lets an AI agent build, test, and manage iOS and macOS Xcode projects through MCP tools or a CLI.

Also known as getsentry/MobileBuildMCP

stdio Developer Tools Workflow Automation DevOps & Infrastructure No API key

Install GitHub ↗

Stars: 6,573
Tools: —
Downloads, 30 days: —
Latest version: —
Last commit: Nov 13, 2026
License: MIT

What is MobileBuildMCP MCP?

MobileBuildMCP lets an AI agent build, test, and manage iOS and macOS Xcode projects through MCP tools or a CLI.

Summary generated from the project's README

About MobileBuildMCP MCP server

Managing iOS and macOS development workflows through an AI agent is what MobileBuildMCP enables. It provides a bridge between AI coding assistants and Xcode, allowing agents to build, test, and manage projects directly. Developers can use it as a dedicated MCP server for clients like Claude Code or Cursor, or interact with it through a unified command-line interface.

Installation is available via Homebrew or npm, and the system requires macOS 14.5 or later along with Xcode 16.x. The tool includes specific logic to skip macro validation during builds to ensure projects using Swift Macros do not encounter errors. For those using the CLI, a per-workspace daemon handles stateful tasks such as log capture and debugging. While the server is designed for agentic use, it also functions as a standard terminal tool for manual project management.

What you can do with it

1Build projects for simulatorsAsk an AI agent to compile a specific Xcode scheme for a simulator target.
2Prepare test productsInstruct the agent to generate portable test products without executing the tests immediately.
3Execute automated testsHave the AI run previously prepared test products on a specific simulator name.
4Manage software updatesUse the CLI to check for and apply version upgrades to the tool.

Written from the project's README. Every use case is checked against a quote from it.

How to install MobileBuildMCP MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "mobilebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "mobilebuildmcp"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "mobilebuildmcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mobilebuildmcp"
      ]
    }
  }
}

$ code --add-mcp '{"name":"mobilebuildmcp","type":"stdio","command":"npx","args":["-y","mobilebuildmcp"]}'

claude_desktop_config.json

{
  "mcpServers": {
    "mobilebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "mobilebuildmcp"
      ]
    }
  }
}

$ codex mcp add mobilebuildmcp -- npx -y mobilebuildmcp

~/.codex/config.toml

[mcp_servers.mobilebuildmcp]
command = "npx"
args = ["-y", "mobilebuildmcp"]

$ gemini mcp add -s user mobilebuildmcp npx -- -y mobilebuildmcp

~/.gemini/settings.json

{
  "mcpServers": {
    "mobilebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "mobilebuildmcp"
      ]
    }
  }
}

No environment variables or API keys required.Setup guides:Claude Code Cursor VS Code Claude Desktop

Automated checks

Ran Nov 12, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)Pass
Commit or release in the last yearPass
Package name not close to a popular packagePass
Remote endpoint uses HTTPSNot checked
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesNot checked

README

View on GitHub

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

Installation

MobileBuildMCP ships as a single package with two modes: a CLI for direct terminal use and an MCP server for AI coding agents. Either install method gives you both.

Option A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp

Option B — npm (Node.js 18+)

npm install -g mobilebuildmcp@latest

Verify either install:

mobilebuildmcp --help

Connect your MCP client

Drop-in config snippets for Cursor, Claude Code, Codex, can be found in the official docs page MCP Clients. Most clients can also run the MCP server on demand via npx -y mobilebuildmcp@latest mcp without a global install.

Requirements

macOS 14.5 or later
Xcode 16.x or later
Node.js 18.x or later (not required for Homebrew installation)

Skills

MobileBuildMCP now includes two optional agent skills:

MCP Skill: Primes the agent with instructions on how to use the MCP server's tools (optional when using the MCP server).
CLI Skill: Primes the agent with instructions on how to navigate the CLI (recommended when using the CLI).

To install with a global binary:

mobilebuildmcp init

Or install directly via npx without a global install:

npx -y mobilebuildmcp@latest init

For further information on installing skills, see Agent Skills.

Notes

MobileBuildMCP requests xcodebuild to skip macro validation to avoid errors when building projects that use Swift Macros.
Device tools require code signing to be configured in Xcode. See Device Code Signing.

Privacy

MobileBuildMCP uses Sentry for internal runtime error telemetry only. For details and opt-out instructions, see Privacy & Telemetry.

CLI

MobileBuildMCP provides a unified command-line interface. The mcp subcommand starts the MCP server, while all other commands provide direct terminal access to tools:

# Install globally
npm install -g mobilebuildmcp@latest

# Start the MCP server (for MCP clients)
mobilebuildmcp mcp

# List available tools
mobilebuildmcp tools

# Build for simulator
mobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj

# Prepare portable test products without running tests
mobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17" --build-for-testing --test-products-path ./MyApp.xctestproducts

# Run previously prepared test products
mobilebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

Check for updates and upgrade in place:

mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes

The CLI uses a per-workspace daemon for stateful operations (log capture, debugging, etc.) that auto-starts when needed. See the CLI guide for full documentation.

Documentation

Installation: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/installation.mdx
Setup: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/setup.mdx
MCP clients: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/clients.mdx
CLI usage: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/cli.mdx
Configuration and options: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx
Tools reference: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx
Troubleshooting: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/troubleshooting.mdx
Privacy: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/privacy.mdx
Skills: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/skills.mdx
Contributing: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/contributing.mdx

Licence

This project is licensed under the MIT License - see the LICENSE file for details. For third-party licensing notices see the THIRD_PARTY_LICENSES file for details. For npm package attributions see the THIRD_PARTY_PACKAGE_LICENSES file for details.

Read full README

MobileBuildMCP MCP questions

How do I add MobileBuildMCP MCP to Claude Code?

Run claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp in your terminal. Add --scope user to make it available in every project.

How do I add MobileBuildMCP MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What does MobileBuildMCP do for iOS and macOS projects?

It provides MCP tools and CLI commands that let agents build, test, and manage Xcode projects for iOS and macOS, including simulator builds and test products.

How do I install MobileBuildMCP?

Install it via Homebrew with the getsentry tap or via npm globally with mobilebuildmcp@latest; both give you the CLI and the MCP server.

What are the system requirements for MobileBuildMCP?

It requires macOS 14.5 or later and Xcode 16.x or later, plus Node.js 18.x or later unless you installed via Homebrew.

Can I build for a simulator from the command line with MobileBuildMCP?

Yes, the CLI includes a simulator build command that takes a scheme and project path.

Does MobileBuildMCP send telemetry?

It uses Sentry only for internal runtime error telemetry, and the docs describe how to opt out.

Facts

Nov 14, 2026

Stars: 6,573
Downloads, 30 days: —
Latest version: —
Last commit: Nov 13, 2026
License: MIT
Transport: stdio
Package: mobilebuildmcp

getsentry ↗

Official publisher

Published by the company that makes the product.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/getsentry/mobilebuildmcp.svg)](https://hostedmcp.org/servers/getsentry/mobilebuildmcp/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

MobileBuildMCP MCP server

✓ Official ✓ VerifiedCommit Nov 13, 2026

getsentry/mobilebuildmcp · typescript · MIT

Lets an AI agent build, test, and manage iOS and macOS Xcode projects through MCP tools or a CLI.

Also known as getsentry/MobileBuildMCP

stdio Developer Tools Workflow Automation DevOps & Infrastructure No API key

Install GitHub ↗

Stars: 6,573
Tools: —
Downloads, 30 days: —
Latest version: —
Last commit: Nov 13, 2026
License: MIT

What is MobileBuildMCP MCP?

MobileBuildMCP lets an AI agent build, test, and manage iOS and macOS Xcode projects through MCP tools or a CLI.

Summary generated from the project's README

About MobileBuildMCP MCP server

What you can do with it

1Build projects for simulatorsAsk an AI agent to compile a specific Xcode scheme for a simulator target.
2Prepare test productsInstruct the agent to generate portable test products without executing the tests immediately.
3Execute automated testsHave the AI run previously prepared test products on a specific simulator name.
4Manage software updatesUse the CLI to check for and apply version upgrades to the tool.

Written from the project's README. Every use case is checked against a quote from it.

How to install MobileBuildMCP MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "mobilebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "mobilebuildmcp"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "mobilebuildmcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mobilebuildmcp"
      ]
    }
  }
}

$ code --add-mcp '{"name":"mobilebuildmcp","type":"stdio","command":"npx","args":["-y","mobilebuildmcp"]}'

claude_desktop_config.json

{
  "mcpServers": {
    "mobilebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "mobilebuildmcp"
      ]
    }
  }
}

$ codex mcp add mobilebuildmcp -- npx -y mobilebuildmcp

~/.codex/config.toml

[mcp_servers.mobilebuildmcp]
command = "npx"
args = ["-y", "mobilebuildmcp"]

$ gemini mcp add -s user mobilebuildmcp npx -- -y mobilebuildmcp

~/.gemini/settings.json

{
  "mcpServers": {
    "mobilebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "mobilebuildmcp"
      ]
    }
  }
}

No environment variables or API keys required.Setup guides:Claude Code Cursor VS Code Claude Desktop

Automated checks

Ran Nov 12, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)Pass
Commit or release in the last yearPass
Package name not close to a popular packagePass
Remote endpoint uses HTTPSNot checked
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesNot checked

README

View on GitHub

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

Installation

MobileBuildMCP ships as a single package with two modes: a CLI for direct terminal use and an MCP server for AI coding agents. Either install method gives you both.

Option A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp

Option B — npm (Node.js 18+)

npm install -g mobilebuildmcp@latest

Verify either install:

mobilebuildmcp --help

Connect your MCP client

Requirements

macOS 14.5 or later
Xcode 16.x or later
Node.js 18.x or later (not required for Homebrew installation)

Skills

MobileBuildMCP now includes two optional agent skills:

MCP Skill: Primes the agent with instructions on how to use the MCP server's tools (optional when using the MCP server).
CLI Skill: Primes the agent with instructions on how to navigate the CLI (recommended when using the CLI).

To install with a global binary:

mobilebuildmcp init

Or install directly via npx without a global install:

npx -y mobilebuildmcp@latest init

For further information on installing skills, see Agent Skills.

Notes

MobileBuildMCP requests xcodebuild to skip macro validation to avoid errors when building projects that use Swift Macros.
Device tools require code signing to be configured in Xcode. See Device Code Signing.

Privacy

MobileBuildMCP uses Sentry for internal runtime error telemetry only. For details and opt-out instructions, see Privacy & Telemetry.

CLI

MobileBuildMCP provides a unified command-line interface. The mcp subcommand starts the MCP server, while all other commands provide direct terminal access to tools:

# Install globally
npm install -g mobilebuildmcp@latest

# Start the MCP server (for MCP clients)
mobilebuildmcp mcp

# List available tools
mobilebuildmcp tools

# Build for simulator
mobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj

# Prepare portable test products without running tests
mobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17" --build-for-testing --test-products-path ./MyApp.xctestproducts

# Run previously prepared test products
mobilebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

Check for updates and upgrade in place:

mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes

The CLI uses a per-workspace daemon for stateful operations (log capture, debugging, etc.) that auto-starts when needed. See the CLI guide for full documentation.

Documentation

Installation: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/installation.mdx
Setup: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/setup.mdx
MCP clients: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/clients.mdx
CLI usage: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/cli.mdx
Configuration and options: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx
Tools reference: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx
Troubleshooting: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/troubleshooting.mdx
Privacy: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/privacy.mdx
Skills: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/skills.mdx
Contributing: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/contributing.mdx

Licence

Read full README

MobileBuildMCP MCP questions

How do I add MobileBuildMCP MCP to Claude Code?

Run claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp in your terminal. Add --scope user to make it available in every project.

How do I add MobileBuildMCP MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What does MobileBuildMCP do for iOS and macOS projects?

It provides MCP tools and CLI commands that let agents build, test, and manage Xcode projects for iOS and macOS, including simulator builds and test products.

How do I install MobileBuildMCP?

Install it via Homebrew with the getsentry tap or via npm globally with mobilebuildmcp@latest; both give you the CLI and the MCP server.

What are the system requirements for MobileBuildMCP?

It requires macOS 14.5 or later and Xcode 16.x or later, plus Node.js 18.x or later unless you installed via Homebrew.

Can I build for a simulator from the command line with MobileBuildMCP?

Yes, the CLI includes a simulator build command that takes a scheme and project path.

Does MobileBuildMCP send telemetry?

It uses Sentry only for internal runtime error telemetry, and the docs describe how to opt out.

Facts

Nov 14, 2026

Stars: 6,573
Downloads, 30 days: —
Latest version: —
Last commit: Nov 13, 2026
License: MIT
Transport: stdio
Package: mobilebuildmcp

getsentry ↗

Official publisher

Published by the company that makes the product.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/getsentry/mobilebuildmcp.svg)](https://hostedmcp.org/servers/getsentry/mobilebuildmcp/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

MobileBuildMCP MCP server

What is MobileBuildMCP MCP?

About MobileBuildMCP MCP server

What you can do with it

How to install MobileBuildMCP MCP

Install MobileBuildMCP MCP in Claude Code

Install MobileBuildMCP MCP in Cursor

Install MobileBuildMCP MCP in VS Code

Install MobileBuildMCP MCP in VS Code CLI

Install MobileBuildMCP MCP in Claude Desktop

Install MobileBuildMCP MCP in Codex

Install MobileBuildMCP MCP in Codex config.toml

Install MobileBuildMCP MCP in Gemini CLI

Install MobileBuildMCP MCP in Gemini settings.json

Automated checks

README

Installation

Option A — Homebrew

Option B — npm (Node.js 18+)

Connect your MCP client

Requirements

Skills

Notes

Privacy

CLI

Documentation

Licence

MobileBuildMCP MCP questions

MobileBuildMCP MCP server

What is MobileBuildMCP MCP?

About MobileBuildMCP MCP server

What you can do with it

How to install MobileBuildMCP MCP

Install MobileBuildMCP MCP in Claude Code

Install MobileBuildMCP MCP in Cursor

Install MobileBuildMCP MCP in VS Code

Install MobileBuildMCP MCP in VS Code CLI

Install MobileBuildMCP MCP in Claude Desktop

Install MobileBuildMCP MCP in Codex

Install MobileBuildMCP MCP in Codex config.toml

Install MobileBuildMCP MCP in Gemini CLI

Install MobileBuildMCP MCP in Gemini settings.json

Automated checks

README

Installation

Option A — Homebrew

Option B — npm (Node.js 18+)

Connect your MCP client

Requirements

Skills

Notes

Privacy

CLI

Documentation

Licence

MobileBuildMCP MCP questions