Quash — Mobile App Automation MCP server

Quash MCP

The Quash MCP server lets an AI agent (Claude Code, Claude Desktop, Cursor, …) drive real mobile-app automation on a connected device: run natural-language test tasks, generate test cases from prompts/docs/repos, manage apps & builds, and pull back streamed runs and reports — all powered by the Quash (mahoraga) automation engine.

This guide covers installing it on macOS or Windows, wiring it into your agent, generating an API token, preparing a device, and using every tool.

Platform support

iOS automation needs Xcode / WebDriverAgent / devicectl / iproxy, which exist

only on macOS — so the iOS tools (setupsimulator, setupdevice) appear in

the macOS build only. Windows is Android-only. Linux x86_64 can be built from

source but isn't published as a release binary.

1. Prerequisites

Windows the installer also detects %LOCALAPPDATA%\Android\Sdk.

• macOS 13+ (Apple Silicon) or Windows 10/11 (x64).
• adb on your PATH (Android platform-tools) for Android automation. On

iOS simulator or a physical iPhone (Developer Mode on, trusted, USB).

• A device: an Android device/emulator (USB debugging on), or — on macOS — an

• A Quash account to authenticate (step 3 for a token, or browser sign-in in step 5).
• For iOS on macOS: Xcode installed (for the WebDriverAgent build).

The installer also downloads the automation engine, a bundled test-generation

component, and the on-device Android Portal APK.

2. Install

One command installs everything and auto-registers the server in every supported agent config it finds (Claude Code, Claude Desktop, Cursor). Pick your platform:

macOS

curl -fsSL https://raw.githubusercontent.com/Oscorp-HQ/quash-mcp-releases/main/install.sh | sh

Windows (PowerShell)

irm https://raw.githubusercontent.com/Oscorp-HQ/quash-mcp-releases/main/install.ps1 | iex

This installs the latest release into ~/.quash (macOS) / %USERPROFILE%\.quash (Windows) and connects to Quash production automatically — no backend URL to configure.

Cursor users: after running the installer above (needed for the engine), you can

one-click add the MCP server to Cursor:

(The installer already auto-registers Cursor, so this is only needed if you skipped that or removed the entry.)

Options (env vars)

macOS gotcha: environment variables must go on the piped sh, not on

curl — a prefix on curl is ignored. On Windows, set $env:… before the irm.

macOS — wire your token in / pin a version:

# Token at install time (recommended — see step 3):
curl -fsSL https://raw.githubusercontent.com/Oscorp-HQ/quash-mcp-releases/main/install.sh | QUASH_API_TOKEN=qsh_xxxxxxxx sh

# Pin a specific version:
curl -fsSL https://raw.githubusercontent.com/Oscorp-HQ/quash-mcp-releases/main/install.sh | QUASH_VERSION=v1.1.0 sh

Windows — same, via $env::

$env:QUASH_API_TOKEN = "qsh_xxxxxxxx"
irm https://raw.githubusercontent.com/Oscorp-HQ/quash-mcp-releases/main/install.ps1 | iex

Shortened. The full README is on GitHub.