MCP iOS Simulator Screenshot
This server captures and manages screenshots from iOS Simulator with several capabilities:
Capture Screenshots: Takes screenshots from the iOS Simulator's current screen
Device Selection: Targets a specific simulator device or defaults to the currently booted device
Customize Output: Specifies output filename and directory for saved screenshots
Resize Images: Optionally resizes screenshots to approximately VGA size (640x480 pixels)
Image Customization: Allows setting maximum width for resized images
Error Handling: Provides detailed error messages for troubleshooting
JSON Response: Returns metadata about captured screenshots including dimensions, format, size, and timestamp
Captures screenshots from iOS Simulator devices and saves them to a specified directory with options for output filename, directory, image resizing, and selecting specific simulator devices.
Runs on macOS to capture iOS Simulator screenshots, requiring macOS as the underlying operating system to access the iOS Simulator environment.
Leverages Xcode Command Line Tools to interact with iOS Simulator devices and capture screenshots through the xcrun simctl command.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP iOS Simulator Screenshot capture a screenshot of the current simulator screen"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP iOS Simulator Screenshot
A server that captures screenshots from iOS Simulator using the Model Context Protocol (MCP).
Overview
This project implements an MCP protocol server that captures the current screen of the iOS Simulator and saves it to a specified directory.
Related MCP server: Screeny MCP Server
Setup
Cline and Roo Code
For Cline and Roo Code, the basic format is:
{
"mcpServers": {
"mcp-ios-simulator-screenshot": {
"command": "npx",
"args": ["-y", "mcp-ios-simulator-screenshot"]
}
}
}If you clone the repository, you can use the following configuration:
{
"mcpServers": {
"mcp-ios-simulator-screenshot": {
"command": "node",
"args": ["/path/to/mcp-ios-simulator-screenshot/build/index.js"]
}
}
}Cursor, Claude Desktop
For Cursor and Claude Desktop, you need to specify the --output-dir and the output directory:
{
"mcpServers": {
"mcp-ios-simulator-screenshot": {
"command": "npx",
"args": [
"mcp-ios-simulator-screenshot",
"--output-dir",
"/path/to/your/output/directory"
]
}
}
}MCP Tool Parameters
get_screenshot
Captures a screenshot from iOS Simulator and saves it to the specified directory.
Parameter | Type | Description | Default Value |
output_filename | string | Output filename | timestamp.png |
output_directory_name | string | Subdirectory name for screenshots | .screenshots |
resize | boolean | Whether to resize the image to approximately VGA size | true |
max_width | integer | Maximum width for resizing (pixels) | 640 |
device_id | string | Specify a simulator device | booted device |
Output Format
On success:
{
"success": true,
"message": "iOS Simulator screenshot saved successfully",
"filePath": ".screenshots/simulator_2025-04-10T16-51-16-755Z.png",
"metadata": {
"width": 1170,
"height": 2532,
"format": "png",
"size": 382946,
"timestamp": "2025-04-10T16:51:16.755Z"
},
"serverConfig": {
"commandLineArgs": {
"outputDir": "/Users/username/Desktop" // Only included when --output-dir is specified
}
}
}Note: The serverConfig.commandLineArgs.outputDir field is only included in the response when the --output-dir parameter is specified when starting the server.
{
"success": false,
"message": "Error capturing iOS Simulator screenshot: [error message]",
"error": {
"code": "ENOENT",
"command": "xcrun simctl io booted screenshot --type=png -",
"stderr": "No matching devices found."
}
}Troubleshooting
If you cannot capture screenshots:
Check if iOS Simulator is running
Check if Xcode Command Line Tools are installed
Check if the
xcrun simctl io booted screenshotcommand can be executed directly
If permission errors occur:
Check if you have write permissions for the output directory
Requirements
Node.js 16.0.0 or higher
macOS (iOS Simulator required)
Xcode Command Line Tools
Technology Stack
TypeScript
Node.js
MCP SDK (@modelcontextprotocol/sdk)
License
MIT
Other Languages
Available Tools
1 toolget_screenshotC
Capture a screenshot from iOS Simulator
Inputs: output_filename, output_directory_name, resize, max_width, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is singular and clearly defined, making it impossible for an agent to misselect between non-existent alternatives.
A single tool inherently has perfect naming consistency, as there are no other tools to compare against. The tool name 'get_screenshot' follows a clear verb_noun pattern, which would be consistent if more tools existed.
A single tool is too few for most practical server purposes, as it severely limits functionality and flexibility. While the server's name suggests a focused domain (iOS Simulator screenshots), one tool feels thin and incomplete for even basic operations like listing simulators or managing screenshots.
The tool surface is severely incomplete for the implied domain of iOS Simulator interactions. It only provides screenshot capture, with obvious gaps such as listing available simulators, starting/stopping simulators, or managing screenshot files, which are essential for a coherent workflow.
Maintenance
Related MCP Connectors
MCP server for Appcircle mobile CI/CD platform.
MCP server to assist with JxBrowser development.
Clean PNG/JPEG screenshots via REST or MCP, with goal-driven multi-step navigation.
Screenshots, PDFs, image editing, QR codes, email validation and more through one hosted MCP server.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server to control iOS Simulators.9 npm53MIT
- AlicenseNot gradedqualityDmaintenanceA privacy-first macOS MCP server that enables AI agents to capture screenshots of pre-approved application windows for development and debugging tasks.18MIT
- AlicenseAqualityDmaintenanceA macOS-based MCP server that allows for capturing screenshots of displays and windows, as well as recording window activity to MP4 files. It leverages a Swift CLI backend to interact with macOS CoreGraphics and AVFoundation APIs for seamless screen capture management.71MIT
- AlicenseNot gradedqualityCmaintenanceMCP server to control iOS simulators for automation, enabling device management, input control, and screen capture via Facebook IDB.11MIT