MCP.so
Sign In

simctl-mcp

@ambar

Repository

About simctl-mcp

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

29

Create a new simulator device

Delete the specified simulator device

Boot simulator device

Shutdown simulator device

Get device environment variable

Open URL in device

Add media files to device

Install app on device

Uninstall app from device

Get installed app container path

Launch app on device

Terminate running app on device

List available simulator devices

List available device types

List available runtimes

Get installed app information

Get device appearance settings

Set device appearance

Send simulated push notification to device

Grant permission to app

Revoke app permission

Reset all app permissions

Add root certificate to device keychain

Add certificate to device keychain

Reset device keychain

Get device screenshot

List installed apps on device

Copy content to the device pasteboard

Get the contents of the device pasteboard

Overview

What is simctl-mcp?

simctl-mcp is a Model Context Protocol (MCP) server implementation that provides programmatic control over iOS Simulators. It enables AI assistants and automation tools to manage devices, apps, permissions, media, and system settings within the iOS Simulator environment.

How to use simctl-mcp?

Run npx -y simctl-mcp (STDIO mode) or npx simctl-mcp --http (HTTP mode, default port 8081). Add the JSON configuration to .cursor/mcp.json or .vscode/mcp.json to register the server with compatible clients.

Key features of simctl-mcp

  • Device management: create, delete, boot, shutdown, and list devices, types, and runtimes
  • App management: install, uninstall, launch, terminate, and inspect apps
  • App permissions: grant, revoke, and reset permissions for installed apps
  • System features: open URLs, add media, manage environment variables and appearance
  • Certificate & security: add root/regular certificates, reset keychain
  • Media & content: take screenshots, get/set pasteboard content, send simulated push notifications

Use cases of simctl-mcp

  • Automate simulator provisioning and testing in CI/CD pipelines
  • Quickly open URLs or deep links in a specific simulator from an AI assistant
  • Install, launch, and manage app permissions for UI automation flows
  • Inject push notifications or set clipboard content for end‑to‑end testing
  • Capture screenshots and manage certificates for security‑related tests

FAQ from simctl-mcp

How do I start simctl-mcp in HTTP mode?

Add the --http flag: npx simctl-mcp --http. Optionally set a custom port with --port <number> or the PORT environment variable.

How do I configure simctl-mcp for Cursor or VS Code?

Add the following JSON to .cursor/mcp.json or .vscode/mcp.json: {"mcpServers":{"simctl-mcp":{"command":"npx","args":["-y","simctl-mcp"]}}}.

What operations does simctl-mcp support?

It provides tools for device management, app management, app permissions, system features (e.g., open URLs, push notifications), certificate management, and media/content actions.

Does simctl-mcp require any dependencies?

No explicit dependencies beyond Node.js (via npx). The server is run directly with npx -y simctl-mcp.

What transport modes does simctl-mcp support?

Two modes: STDIO (default) and HTTP (with --http flag). No authentication or other transports are mentioned.

Frequently asked questions

How do I start simctl-mcp in HTTP mode?

Add the `--http` flag: `npx simctl-mcp --http`. Optionally set a custom port with `--port <number>` or the `PORT` environment variable.

How do I configure simctl-mcp for Cursor or VS Code?

Add the following JSON to `.cursor/mcp.json` or `.vscode/mcp.json`: `{"mcpServers":{"simctl-mcp":{"command":"npx","args":["-y","simctl-mcp"]}}}`.

What operations does simctl-mcp support?

It provides tools for device management, app management, app permissions, system features (e.g., open URLs, push notifications), certificate management, and media/content actions.

Does simctl-mcp require any dependencies?

No explicit dependencies beyond Node.js (via npx). The server is run directly with `npx -y simctl-mcp`.

What transport modes does simctl-mcp support?

Two modes: STDIO (default) and HTTP (with `--http` flag). No authentication or other transports are mentioned.

Comments

Basic information

Category

Other

License

MIT

Transports

stdio

Author

ambar

More Other MCP servers

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

ICSS

chokcoco

不止于 CSS

20.7K