About Xcode MCP
Xcode MCP is an MCP server published by ebowwa in the Developer Tools category: mCP server for Xcode - enables AI assistants to create, build, test, and manage iOS/macOS projects programmatically.
The repository has 5 stars and 1 forks, with the last commit 3 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/ebowwa/xcode-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (5)
xcode_archiveCreate .xcarchive for distribution
Parameters not published.
xcode_buildBuild an Xcode project/workspace
Parameters not published.
xcode_cleanClean build folder
Parameters not published.
xcode_show_build_settingsShow all build settings for a scheme
Parameters not published.
xcode_testRun unit/UI tests
Parameters not published.
Ask AI
Ask AI about Xcode MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 6 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
@ebowwa/mcp-xcode
Xcode MCP server - build, test, run, and manage simulators from Claude Code.
Installation
npm install @ebowwa/mcp-xcode
Requirements
- macOS (Darwin)
- Xcode Command Line Tools (
xcode-select --install)
Tools
Build Tools
| Tool | Description |
|---|---|
xcode_build |
Build an Xcode project/workspace |
xcode_test |
Run unit/UI tests |
xcode_archive |
Create .xcarchive for distribution |
xcode_clean |
Clean build folder |
xcode_show_build_settings |
Show all build settings for a scheme |
Project Info
| Tool | Description |
|---|---|
xcode_project_info |
Get project/workspace info |
xcode_scheme_list |
List all schemes |
xcode_destination_list |
List available destinations |
Simulator Tools
| Tool | Description |
|---|---|
xcode_simulator_list |
List all available simulators |
xcode_simulator_boot |
Boot a simulator |
xcode_simulator_shutdown |
Shutdown simulator(s) |
xcode_simulator_install |
Install app on simulator |
xcode_simulator_launch |
Launch app on simulator |
xcode_simulator_terminate |
Terminate app on simulator |
xcode_simulator_open_url |
Open URL on simulator |
xcode_simulator_take_screenshot |
Take screenshot |
Device Tools
| Tool | Description |
|---|---|
xcode_device_list |
List connected physical devices |
xcode_runtime_list |
List installed iOS/tvOS/watchOS runtimes |
Usage Examples
Build a Scheme
{
"scheme": "MyApp",
"destination": "platform=iOS Simulator,name=iPhone 15"
}
Run Tests
{
"scheme": "MyAppTests",
"onlyTesting": "MyAppTests/MyTestCase/testExample"
}
Boot Simulator
{
"name": "iPhone 15",
"runtime": "iOS 17.2"
}
Install and Launch App
{
"appPath": "/path/to/MyApp.app",
"bundleId": "com.mycompany.myapp"
}
Claude Code Configuration
Add to your ~/.claude.json:
{
"mcpServers": {
"xcode": {
"command": "bun",
"args": ["run", "/path/to/mcp-xcode/dist/index.js"]
}
}
}
License
MIT
README fetched from the repository 6 days ago. The original is authoritative.