MobileBuildMCP Server: Setup for Claude, Cursor and Other Apps

• Shows the project, scheme and simulator it will use

  Shows the defaults for the current session. The tool description says to call it before the first build, run or test so it does not assume anything is set.

  Try: “What project and simulator are you set to use?”

  Read · session_show_defaults

• Sets the project, scheme and simulator for the session

  Stores the project path, scheme and simulator so later build and run calls do not need them each time. You can keep several named profiles.

  Try: “Use MyApp.xcworkspace, the MyApp scheme and the iPhone 17 simulator.”

  Write · session_set_defaults

• Finds Xcode projects in a folder

  Scans a folder, by default the workspace root, for .xcodeproj and .xcworkspace files.

  Try: “Find the Xcode projects in this repo.”

  Files · discover_projs

• Lists the schemes in a project

  Lists the build schemes in an Xcode project or workspace.

  Try: “What schemes does this project have?”

  Read · list_schemes

• Shows a scheme's build settings

  Prints the build settings for a scheme.

  Try: “Show the build settings for the MyApp scheme.”

  Read · show_build_settings

• Lists iOS simulators

  Lists the iOS simulators on your Mac.

  Try: “Which simulators do I have?”

  Read · list_sims

• Boots a simulator

  Starts an iOS simulator for manual work. It is not needed before build_run_sim.

  Try: “Boot the iPhone 17 simulator.”

  Runs code · boot_sim

• Opens the Simulator app

  Brings up the Simulator window so you can watch what the agent is doing.

  Try: “Open the Simulator so I can watch.”

  Runs code · open_sim

• Builds the app for the simulator

  Compiles the app for an iOS simulator without launching it. The build runs xcodebuild on your machine.

  Try: “Build the MyApp scheme for the simulator.”

  Runs code · build_sim

• Builds, installs and launches on the simulator

  Builds the scheme, installs it on a simulator, boots one if needed, and launches the app. Runtime logs are captured to a file and the path is returned.

  Try: “Build and run MyApp on the iPhone 17 simulator and show me any crash logs.”

  Runs code · build_run_sim

• Runs your tests on the simulator

  Runs the test target on an iOS simulator.

  Try: “Run the unit tests for MyApp on the simulator.”

  Runs code · test_sim

• Installs an app on the simulator

  Installs a built .app on a simulator.

  Try: “Install the built app on the simulator.”

  Runs code · install_app_sim

• Launches an app on the simulator

  Launches an installed app by bundle ID and captures its runtime logs to a file.

  Try: “Launch com.example.myapp on the simulator.”

  Runs code · launch_app_sim

• Stops an app on the simulator

  Stops a running app in the simulator.

  Try: “Stop the app in the simulator.”

  Runs code · stop_app_sim

• Records the simulator screen to a video

  Records a video of the simulator screen.

  Try: “Record a video while I walk through the sign-up flow.”

  Write · record_sim_video

• Takes a simulator screenshot

  Captures a screenshot of the simulator.

  Try: “Take a screenshot of the current screen.”

  Read · screenshot

• Reads the screen's interface elements

  Captures a snapshot of the simulator's interface with a reference for each element, so the agent can tap the right one.

  Try: “Describe what is on screen right now.”

  Read · snapshot_ui

• Taps an element in the simulator

  Taps one interface element in the simulator by its reference from the latest snapshot.

  Try: “Tap the Sign In button.”

  Runs code · tap

• Types text in the simulator

  Types text into the focused field in the simulator.

  Try: “Type "test@example.com" into the email field.”

  Runs code · type_text

• Swipes in the simulator

  Swipes across the simulator screen.

  Try: “Swipe up to scroll the list.”

  Runs code · swipe

• Waits until something appears on screen

  Polls the interface until the text or element you describe shows up or settles.

  Try: “Wait until the Welcome text is on screen.”

  Read · wait_for_ui

• Sets the simulator's GPS location

  Sets a fake location for the simulator.

  Try: “Put the simulator in Berlin.”

  Runs code · set_sim_location

• Erases a simulator

  Erases a simulator and its content. The manifest marks it as destructive. It is in the simulator-management group, which is off by default.

  Try: “Erase the iPhone 17 simulator.”

  Delete · erase_sims

• Builds and runs on a connected device

  Builds, installs and launches the app on a physical iPhone or iPad. Needs code signing set up in Xcode, and the device group has to be turned on.

  Try: “Build and run MyApp on my iPhone.”

  Runs code · build_run_device

• Builds and runs a macOS app

  Builds and launches a macOS app. The macOS group has to be turned on.

  Try: “Build and run the macOS target.”

  Runs code · build_run_macos

• Runs Swift package tests

  Runs the tests for a Swift package target. The swift-package group has to be turned on.

  Try: “Run the tests for the Core package.”

  Runs code · swift_package_test

• Cleans build products

  Deletes build products for a project. The manifest marks it as destructive. It is part of the default simulator group, so it is available without turning anything on.

  Try: “Clean the build products for MyApp.”

  Delete · clean

• Attaches LLDB to a simulator app

  Attaches the debugger to an app running in the simulator. The debugging group has to be turned on.

  Try: “Attach the debugger to MyApp.”

  Runs code · debug_attach_sim

• Runs an LLDB command

  Runs any LLDB command you or the agent give it. The manifest marks it as destructive.

  Try: “Run "po self.viewModel" in the debugger.”

  Runs code · debug_lldb_command

• Shows code coverage per target

  Reads an xcresult bundle and shows coverage for each target. The coverage group has to be turned on.

  Try: “Show coverage from the last test run.”

  Files · get_coverage_report

• Creates a new iOS project

  Creates a new iOS project from a template. The project-scaffolding group has to be turned on.

  Try: “Create a new SwiftUI iOS app called Notes.”

  Write · scaffold_ios_project

• Calls a tool in the Xcode IDE

  Calls a tool exposed by Xcode itself through its bridge. The manifest marks it as destructive and it needs the xcode-ide group.

  Try: “Capture a SwiftUI preview from Xcode.”

  Runs code · xcode_ide_call_tool

Watch out for

• The default tools include a delete

  The simulator group is on by default and contains clean, which deletes build products for a project. Tell the assistant not to clean unless you ask. github.com

• Builds run your project's build steps

  Building and testing run xcodebuild on your machine, which can run scripts that belong to the project. Only build projects you trust. github.com

• Optional groups add delete and debugger tools

  Turning on more groups adds tools that erase simulators and run any LLDB command you or the agent give it, and the Xcode bridge tool is marked destructive too. Enable them only when needed. github.com

• Error reports go to Sentry by default

  The server sends reports about its own crashes. The privacy page says tool inputs and outputs are not sent and shows how to opt out. github.com

Security advisories