simctl-mcp

simctl-mcp

A Model Context Protocol server for automating iOS Simulator control.

13
Stars
4
Forks
13
Watchers
0
Issues
simctl-mcp implements a Model Context Protocol (MCP) server that allows for remote and automated management of iOS Simulator devices and applications. It supports both STDIO and HTTP server modes for flexible integration into development workflows. The tool provides functionality for device management, app lifecycle operations, permission handling, system features, certificate management, and media content manipulation. It is designed to facilitate AI-driven or prompt-based interactions with the iOS Simulator environment.

Key Features

Supports both STDIO and HTTP server modes
Automates creation and deletion of simulator devices
Boots and shuts down simulator devices
Manages installation and uninstallation of apps
Launches and terminates simulator applications
Lists devices, device types, runtimes, and installed apps
Manages app permissions (grant, revoke, reset)
Handles simulator environment variables and appearance settings
Supports certificate installation and keychain resets
Takes screenshots and manages simulator clipboard content

Use Cases

Automated iOS app testing in CI/CD pipelines
Remote control of iOS Simulator for development teams
Scripted device and app management for rapid prototyping
Prompt-driven queries and actions via conversational AI interfaces
Granting or revoking app permissions during testing scenarios
Injecting media files and push notifications during app development
Setting up test environments with required root certificates
Fetching app metadata and runtime information programmatically
Managing simulator device states for parallel testing
Automated generation of Appium connection strings for mobile app automation

README

simctl-mcp

A Model Context Protocol server implementation for iOS Simulator control.

Trust Score Install MCP Server

Config

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

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.

bash
npx simctl-mcp

HTTP Server Mode

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

bash
# 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)

Star History

Star History Chart

Repository Owner

ambar
ambar

User

Repository Details

Language TypeScript
Default Branch main
Size 68 KB
Contributors 2
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

TypeScript
94.46%
JavaScript
5.54%

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • iOS Simulator MCP Server

    iOS Simulator MCP Server

    Programmatic control of iOS simulators via the Model Context Protocol

    iOS Simulator MCP Server implements the Model Context Protocol (MCP) to provide a standardized interface for managing iOS simulators. It enables users to list simulators, boot or shut them down, install application bundles, and launch apps by bundle ID. By conforming to the MCP specification, it allows seamless integration with tools that require structured simulator management.

    • 46
    • MCP
    • JoshuaRileyDev/simulator-mcp-server
  • iOS Simulator MCP Server

    iOS Simulator MCP Server

    A Model Context Protocol server for controlling and automating iOS simulators.

    Provides a Model Context Protocol (MCP) server that enables interactions with iOS simulators. Allows users to obtain simulator information, automate UI interactions such as tapping, typing, swiping, and retrieve accessibility data. Designed for robust integration with automation, testing, and developer workflows via standardized MCP commands.

    • 1,231
    • MCP
    • joshuayoes/ios-simulator-mcp
  • MCP Server for iOS Simulator

    MCP Server for iOS Simulator

    Enables LLM-powered natural language control of iOS simulators.

    MCP Server for iOS Simulator provides a protocol-compliant bridge between large language models and iOS simulators, allowing seamless control via natural language commands. It offers comprehensive simulator management, application lifecycle handling, advanced UI interaction, and extensive debugging capabilities. Designed for macOS, the server integrates directly with existing MCP ecosystems, supporting development, testing, and automation workflows.

    • 275
    • MCP
    • InditexTech/mcp-server-simulator-ios-idb
  • Xcode MCP Server

    Xcode MCP Server

    Comprehensive Xcode integration server for AI assistants using the Model Context Protocol.

    Xcode MCP Server provides an MCP-compliant interface for AI agents to interact with Xcode projects on macOS. It supports project management, simulator control, CocoaPods and Swift Package Manager integration, and advanced file and build operations. Enhanced error handling and multi-project support enable seamless automation and context management for complex Xcode workflows.

    • 330
    • MCP
    • r-huijts/xcode-mcp-server
  • AutoMobile

    AutoMobile

    Powerful tools for mobile automation, test authoring, and device management via MCP.

    AutoMobile provides a comprehensive set of tools for mobile automation, focusing on UI testing and development workflow automation. It operates as an MCP Server, enabling a robust interaction loop for model-driven actions and observations. The solution supports Android platforms with features like automated test authoring, multi-device management, and seamless CI test execution. AutoMobile also offers source mapping and deep view hierarchy analysis to enhance code rendering accuracy.

    • 63
    • MCP
    • zillow/auto-mobile
  • Mac Apps Launcher MCP Server

    Mac Apps Launcher MCP Server

    Launch and manage macOS applications via an MCP server.

    Mac Apps Launcher MCP Server enables the listing, launching, and management of macOS applications through the Model Context Protocol. Designed to integrate with systems supporting MCP, it provides standardized methods to enumerate app folders, launch apps by name, and open files with specified applications. Configuration details are provided for integration with Claude Config JSON.

    • 16
    • MCP
    • JoshuaRileyDev/mac-apps-launcher
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results