Swipium
Let coding agents QA mobile apps on Android emulators and iOS simulators
- 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 swipiumAdd 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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools