Quash MCP

Nishtha chauhan
Nishtha chauhan
|Published on |5 mins
Cover Image for Quash MCP

The Quash MCP server connects Quash mobile-app automation to the AI agent you already work in. With it installed, Claude Code, Claude Desktop, or Cursor can drive real automation on a connected device. You describe what you want in plain language, and the agent runs it.

What you can do

Once it's connected, the agent can reach the full Quash workflow:

  • Run tests.

    Run a natural-language test task on the device and stream the result back live.

  • Generate test cases.

    Build test cases from a prompt, from files, or straight from a git repo.

  • Manage apps and builds.

    List your org's apps, list builds, and install a build's APK on the device.

  • Review results.

    Browse recent runs, pull a run's report and share link, and check your plan usage and limits.

You don't memorize any commands. You ask the agent in plain language and it picks the right tool.

Ebook Preview

Get the Mobile Testing Playbook Used by 800+ QA Teams

Discover 50+ battle-tested strategies to catch critical bugs before production and ship 5-star apps faster.

100% Free. No spam. Unsubscribe anytime.

The MCP tools

For reference, here's the full set of tools the agent has access to:

Tool

What it does

Platform

about

Shows the running version, the latest release, and the update command.

All

auth

Signs you in, via Google browser flow or an API token.

All

connect

Detects and selects a device, then health-checks adb, Portal, engine, and auth.

All

configure

Views or changes execution and test-generation settings, including your signing team.

All

setup_portal

Installs the Android Portal app and enables accessibility.

All

setup_simulator

Builds and launches WebDriverAgent for an iOS simulator.

macOS

setup_device

Signs and launches WebDriverAgent on a physical iPhone over USB.

macOS

execute

Runs a natural-language test task on the device and streams the run back.

All

generate_test_cases

Generates test cases from a prompt, files, or a git repo.

All

usage

Reports your current plan, remaining minutes, and feature limits.

All

list_apps

Lists the apps in your organization.

All

builds

Lists the builds for an app.

All

install_build

Downloads a build's APK and installs it on the device.

All

runs

Browses recent runs, or fetches one run's report and share link.

All

test_cases / suites

Browses your test cases and suites.

All

Platform support

On macOS (Apple Silicon) you get both Android and iOS automation. On Windows (x64) the server is Android only, because iOS automation depends on Apple's macOS-only toolchain.

It works across emulators and physical devices: Android physical devices and emulators on both platforms, plus iOS simulators and physical iPhones on macOS.

Install

One command installs the server and auto-registers Quash in every supported agent it finds.

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

You'll need adb on your PATH, a connected device or emulator with USB debugging on, and a Quash account. To authenticate, generate an API token in the desktop app under Settings → Integrations (it starts with qsh_). Set it as QUASH_API_TOKEN and the server signs in automatically on startup. Prefer no token? The agent can run a Google browser sign-in instead.

Getting started

"Use Quash: connect, then run setup_portal if needed." (Android)"Use Quash: connect, then setup_simulator." (iOS simulator on macOS)
"Run this on the device: open Settings and turn on Airplane mode."
"Show me the report for that run."
"Generate test cases for https://github.com/acme/my-app."

Full setup steps and troubleshooting live in the setup guide.

The Quash MCP server is available today. Install it, connect a device, and run your first test without leaving your agent.

Frequently Asked Questions

What is the Quash MCP server? It's a server that connects Quash mobile-app automation to an AI agent (Claude Code, Claude Desktop, or Cursor), so the agent can run tests, generate test cases, manage builds, and pull reports on a connected device using plain language.

Which platforms does it support? macOS (Apple Silicon) supports both Android and iOS, including simulators and physical iPhones. Windows (x64) is Android only.

Can I run iOS tests on Windows? No. iOS automation requires Apple's macOS-only toolchain, so iOS coverage needs a Mac.

How do I authenticate? Generate an API token in the desktop app under Settings → Integrations and set it as QUASH_API_TOKEN for automatic sign-in, or have the agent run a Google browser sign-in.