Back to Catalog

simctl-mcp

ambar/simctl-mcp
🔗 Latest commit:b3c0fe5
🕒 Updated:Aug 4, 2025, 09:35 AM
TypeScript
Development

MCP server from ambar/simctl-mcp

MCP Trust Score
Based on our comprehensive evaluation criteria
🤖 Evaluated by gemini-2.5-flashFix
Trust Score47/100
GitHub Metrics
Repository statistics and activity
⭐ GitHub Stars:10
👥 Contributors:1
📋 Total Issues:0
📦 Has Releases:No
🔧 Has CI/CD Pipeline:No
MCP Protocol Support
Implemented MCP protocol features
🤖 Evaluated by gemini-2.5-flashFix
Tools:
Prompts:
Resources:
Sampling:
Roots:
Logging:
STDIO Transport:
HTTP Transport:
OAuth2 Auth:
Dependencies
5 dependencies
Libraries and frameworks used by this MCP server
🤖 Evaluated by gemini-2.5-flashFix
Configuration
Configuration example extracted from README.md for Claude Desktop and other clients.
🤖 Evaluated by gemini-2.5-flashFix
{
  "mcpServers": {
    "simctl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "simctl-mcp"
      ],
      "env": {}
    },
    "simctl-mcp-stdio": {
      "command": "npx",
      "args": [
        "simctl-mcp"
      ],
      "env": {}
    },
    "simctl-mcp-http": {
      "command": "npx",
      "args": [
        "simctl-mcp",
        "--http"
      ],
      "env": {}
    },
    "simctl-mcp-http-port-3000": {
      "command": "npx",
      "args": [
        "simctl-mcp",
        "--http",
        "--port",
        "3000"
      ],
      "env": {}
    },
    "simctl-mcp-http-env-port": {
      "command": "npx",
      "args": [
        "simctl-mcp",
        "--http"
      ],
      "env": {
        "PORT": "3000"
      }
    }
  }
}
Add Quality Badge
Show your MCP trust score in your README
Trust Score Badge
[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/ambar/simctl-mcp)](https://archestra.ai/mcp-catalog/ambar__simctl-mcp)
README.md

simctl-mcp

A Model Context Protocol server implementation for iOS Simulator control.

Install MCP Server

Config

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

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

Prompts

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

Usage

The server can be started in two modes:

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

STDIO Mode

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

npx simctl-mcp

HTTP Server Mode

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

Tools

Device Management:

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

App Management:

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

App Permissions:

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

System Features:

  • Open URLs in simulator
  • Add media files
  • Get/Set environment variables
  • Get/Set appearance (light/dark mode)
  • Send simulated push notifications

Certificate & Security:

  • Add root certificates
  • Add regular certificates
  • Reset keychain

Media & Content:

  • Take screenshots
  • Get/Set pasteboard content (clipboard)
simctl-mcp MCP Server | Documentation & Integration | Archestra