peeko
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., "@peeko Take a screenshot of the iPhone simulator and tell me if the button alignment looks correct."
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.
peeko
Let Claude see your mobile app. Peeko is an MCP server that hands Claude screenshots of your iOS Simulator, Android emulator, or a physical Android device plugged into USB.
It is deliberately read-only. Peeko observes; it never taps, swipes, or types. Claude can look at what your app is rendering and reason about it — a layout that broke, a state you can't reproduce in words, a diff between what you meant and what shipped — without ever touching the device.
You: Why does the login screen look wrong on the iPhone 16?
Claude: [screenshot_ios] The "Continue" button is clipped — its container has a
fixed height of 44pt but the text wraps to two lines at this width.Requirements
Platform | iOS Simulators | Android devices & emulators |
macOS | ✅ Xcode required | ✅ |
Linux | ❌ not possible | ✅ |
Windows | ❌ not possible | ✅ |
iOS support is macOS-only, and always will be: it relies on xcrun simctl, which ships with Xcode and does not exist on other operating systems. On Linux and Windows the three iOS tools return a clear error and the Android tools work normally.
Node.js 18 or later is required.
Installing the prerequisites
Xcode command line tools (macOS, for iOS):
xcode-select --installAndroid platform tools (all platforms, for Android):
macOS —
brew install --cask android-platform-toolsLinux —
apt install android-tools-adb(or your distribution's equivalent)Windows —
winget install Google.PlatformTools
Make sure adb ends up on your PATH. Peeko tells you so explicitly if it doesn't.
Related MCP server: macOS Simulator MCP Server
Install
Every agent at once
add-mcp detects the agents installed on your machine and writes the right config for each one:
npx add-mcp peeko@latestAdd -g to install globally rather than for the current project, and -a to target specific agents — claude-code, claude-desktop, codex, cursor, gemini-cli, goose, opencode, vscode, zed.
Claude Code
As a plugin, which needs no MCP configuration at all:
claude plugin marketplace add rocktane/peeko
claude plugin install peeko@peekoOr as a plain MCP server:
claude mcp add peeko -- npx -y peeko@latestCodex
codex mcp add peeko -- npx -y peeko@latestopencode
opencode is configured by file only. In opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"peeko": {
"type": "local",
"command": ["npx", "-y", "peeko@latest"],
"enabled": true
}
}
}Cursor, Claude Desktop, and other MCP clients
Add this to your client's MCP configuration:
{
"mcpServers": {
"peeko": {
"command": "npx",
"args": ["-y", "peeko@latest"]
}
}
}Tools
Tool | What it does |
| Lists every booted iOS Simulator, with its UDID. |
| Returns a PNG of a Simulator's screen. |
| Name, OS version and screen size of a Simulator. |
| Lists every connected Android device and emulator. |
| Returns a PNG of a device's screen. |
| Name, OS version and screen size of a device. |
Every tool takes an optional device_id — a Simulator UDID on iOS, a device serial on Android. Omit it and Peeko picks the first available device, which is what you want when only one is running.
Usage
Boot a simulator or emulator, then just ask:
Take a screenshot of the simulator and tell me if the spacing looks right.
Compare the Android and iOS home screens side by side.
The list is empty on Android but not on iOS — screenshot both and tell me what differs.
Privacy
Screenshots are sent to the model, exactly like any other tool result. Whatever is on the device screen goes with them — test accounts, tokens in a debug overlay, a customer's real data if you are pointed at production. Peeko cannot tell the difference. Check what's on screen before you ask for a capture.
Peeko never writes to the device, never installs anything on it, and never sends data anywhere other than the MCP client that invoked it.
Development
Peeko is written in TypeScript. It runs on Node in production, and uses Bun as the dev runtime and test runner.
bun install
bun test # unit tests on the parsers
bun run typecheck # tsc --noEmit
bun run build # tsc → dist/
bun run start # run the server from source over stdioThe repo ships a .mcp.json that points at src/index.ts, so opening it in Claude Code gives you the server you're editing, live.
Layout
src/
index.ts MCP server: tool registration and stdio transport
tools/ one handler per tool; formats MCP results
platforms/
ios.ts xcrun simctl
android.ts adb
exec.ts subprocess helper; turns ENOENT into actionable errors
png.ts reads dimensions from a PNG's IHDR chunk
test/
parsers.test.ts covers the pure parsing functionsThe device-facing code shells out to xcrun and adb, so it can't be unit-tested without hardware. The parsers it depends on are pure functions and are tested directly — including CRLF handling, which is what makes Android work on Windows.
Contributing
Issues and pull requests are welcome. Please run bun test and bun run typecheck before opening a PR; CI runs both on Linux, macOS and Windows.
License
MIT © Yohan (@rocktane)
Available Tools
6 toolsinfo_androidA
Get detailed info about an Android device/emulator (name, OS version, screen size)
Inputs: device_id.
info_iosA
Get detailed info about an iOS Simulator (name, OS version, screen size). (macOS only)
Inputs: device_id.
list_android_emulatorsB
List all connected Android devices and emulators
Inputs: no named parameters.
list_ios_simulatorsA
List all booted iOS Simulators (macOS only)
Inputs: no named parameters.
screenshot_androidB
Take a screenshot of an Android device/emulator screen. Returns a PNG image.
Inputs: device_id.
screenshot_iosA
Take a screenshot of an iOS Simulator screen. Returns a PNG image. (macOS only)
Inputs: device_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a specific platform (Android or iOS) and action (info, list, screenshot), with no overlap or ambiguity.
All tools follow a consistent pattern: <action>_<platform> (e.g., info_android, list_ios_simulators), using lowercase with underscores.
Six tools cover the core operations for two platforms (listing, info, screenshots) without excess or deficiency.
The tool surface is complete for the stated purpose of retrieving device/simulator info, listing, and screenshots; no obvious gaps.
Maintenance
Related MCP Connectors
Hosted Screenshots MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Cloud Android 14 phones that Claude, Claude Code, Cursor and Codex can use over MCP. Ready in ~15 s. Plain-English tasks return pass/fail, steps, screenshots and video. 1¢ per phone-minute, AI included, 100 free minutes a month.
Pocket Agent (aipocketagent.com) MCP server — read tools for personas, apps, and product info.
Hosted iOS app intelligence and creative research MCP server.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA server enabling programmatic control over Android devices through ADB, providing capabilities like screenshot capture, UI layout analysis, and package management that can be accessed by MCP clients like Claude Desktop.811Apache 2.0
- FlicenseNot gradedqualityDmaintenanceAn MCP server that allows AI tools like Claude Desktop, Claude Code, and Cursor to visually interact with macOS applications by capturing screenshots and controlling the mouse and keyboard.14-
- AlicenseAqualityDmaintenanceAn MCP server that enables Claude Code to visually test and control iOS simulators, Android emulators, and real devices through 22 automation tools. It automatically generates test reports with screenshots for mobile app testing directly from the terminal.2415 npm1MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that lets AI agents control iOS and Android devices (tap, scroll, type, take screenshots, read UI trees, and run code). Works with multiple devices at the same time.91 npm53MIT