Skip to content
MCP server

Swipium

Let coding agents QA mobile apps on Android emulators and iOS simulators

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
2.4.0
Listing updated
3 days ago

About Swipium

Swipium is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Swipium gives an agent the loop a QA engineer follows: find or build the app, boot a simulator, install and launch it, read the screen, tap and type through user flows, and write a report backed by screenshots, logs and UI dumps. A run can then be turned into a repeatable flow, a test suite or Appium code.

It runs locally as a stdio server and opens no network port, driving devices through adb, simctl and WebDriverAgent rather than Appium. Physical devices are refused on purpose, and it asks for consent before builds, installs, data wipes or other side effects. Credentials and tokens are redacted from output. Each session produces a self-contained HTML report, with JUnit and GitHub job summary exports for CI.

Android Emulator works on macOS and Linux, iOS Simulator on macOS only, and Windows is experimental. Node.js 22.12 or newer is required. Test logins are passed through SWIPIUM_TEST_EMAIL and SWIPIUM_TEST_PASSWORD.

Install

Run in a terminal

claude mcp add swipium --env SWIPIUM_TEST_PASSWORD='<SWIPIUM_TEST_PASSWORD>' -- npx -y swipium

Add to claude_desktop_config.json

{
  "mcpServers": {
    "swipium": {
      "command": "npx",
      "args": [
        "-y",
        "swipium"
      ],
      "env": {
        "SWIPIUM_TEST_PASSWORD": "<SWIPIUM_TEST_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "swipium": {
      "command": "npx",
      "args": [
        "-y",
        "swipium"
      ],
      "env": {
        "SWIPIUM_TEST_PASSWORD": "<SWIPIUM_TEST_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "swipium": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "swipium"
      ],
      "env": {
        "SWIPIUM_TEST_PASSWORD": "<SWIPIUM_TEST_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "swipium": {
      "command": "npx",
      "args": [
        "-y",
        "swipium"
      ],
      "env": {
        "SWIPIUM_TEST_PASSWORD": "<SWIPIUM_TEST_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "swipium": {
      "command": "npx",
      "args": [
        "-y",
        "swipium"
      ],
      "env": {
        "SWIPIUM_TEST_PASSWORD": "<SWIPIUM_TEST_PASSWORD>"
      }
    }
  }
}

Configuration

  • SWIPIUM_PROJECT_ROOTAbsolute path of the mobile app repo when the client exposes no workspace root.
  • SWIPIUM_TEST_EMAILTest account email or username for login flows.
  • SWIPIUM_TEST_PASSWORDTest account password for login flows.

What it does

Simulator control
Boot targets, install and launch apps, take snapshots and run UI actions.
Evidence-backed reports
Screenshots, logs and UI dumps feed one HTML report with a release-risk summary.
Durable app map
Screens, flows, issues and generated test cases are saved under the project.
Reusable outputs
Turn explorations into flows, suites or Appium code.
Consent and redaction
Side-effect actions ask first, and secrets are masked.

Good for

  • Smoke test an app before a TestFlight or Play Console build
  • Catch a broken login screen automatically
  • Generate a regression suite from an exploratory run
  • Attach a JUnit report to a CI job

Pricing

Open source

Prices change. Check swipium.com before you buy.

Swipium FAQ

Does it work on physical devices?

No. They are refused on purpose; only emulators and simulators are supported.

Which clients can use it?

Claude Code, Codex, Gemini CLI, Cursor, VS Code, Grok and other stdio MCP clients.

Is it free?

The site says it is free and open source.

What does it need?

Node.js 22.12 or newer, plus Xcode for iOS Simulator.

Is Swipium free?

Yes. Swipium is open source, so you can use and self-host it for free.

How do I add Swipium to Claude Code?

Run this command in your terminal: claude mcp add swipium --env SWIPIUM_TEST_PASSWORD='<SWIPIUM_TEST_PASSWORD>' -- npx -y swipium

What are the best alternatives to Swipium?

The closest alternatives to Swipium are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Swipium

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools