simctl-mcp

A Model Context Protocol server implementation for iOS Simulator control.

[](https://archestra.ai/mcp-catalog/ambar__simctl-mcp) [](https://cursor.com/install-mcp?name=simctl-mcp&config=eyJjb21tYW5kIjoibnB4IC15IHNpbWN0bC1tY3AifQ%3D%3D)

.cursor/mcp.json or .vscode/mcp.json:

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

Some examples of prompts:

• What operations does the simulator support?
• Open shortcuts://
• What is the bundle ID of the "Settings" app?
• Set clipboard content to: Hello
• What is the simulator SDK version?
• Generate an Appium connection string for the "Settings" app

The server can be started in two modes:

1. STDIO Mode (default)
2. HTTP Server Mode

In STDIO mode, the server communicates through standard input/output streams.

npx simctl-mcp

In HTTP server mode, the server listens for HTTP connections on a specified port.

# Start with default port (8081)
npx simctl-mcp --http

# Start with custom port using --port flag
npx simctl-mcp --http --port 3000

# Start with custom port using environment variable
PORT=3000 npx simctl-mcp --http

• Create new simulator devices
• Delete existing devices
• Boot devices
• Shutdown devices
• List all available devices
• List available device types
• List available runtimes

• Install apps
• Uninstall apps
• Launch apps
• Terminate running apps
• Get app container path
• Get app information
• List installed apps

• Grant permissions to apps
• Revoke app permissions
• Reset all app permissions

• Open URLs in simulator
• Add media files
• Get/Set environment variables
• Get/Set