# Swipium

> Swipium is an open-source MCP server for developer tools. Let coding agents QA mobile apps on Android emulators and iOS simulators. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://swipium.com
- **Repository:** https://github.com/geropalombo/swipium
- **MCP Registry name:** io.github.GeroPalombo/swipium
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/swipium
