# Rocuronium

> Rocuronium is an open-source MCP server for productivity. Let an agent click and type in Mac apps while you keep using your cursor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Website:** https://kagerou.glass/rocuronium/
- **Repository:** https://github.com/kageroumado/rocuronium
- **MCP Registry name:** glass.kagerou/rocuronium
- **Categories:** productivity, developer tools
- **Listing updated:** 2026-11-14

## About

Instead of grabbing the mouse, Rocuronium sends clicks and keystrokes through accessibility or per-process events, so your cursor and focus stay where they were. Each action returns a verdict of confirmed, noEffect or unverifiable, backed by read-back values, accessibility-tree changes or pixel comparison. A noEffect result means the API reported success but nothing visibly changed.

A small status panel names the current goal and step. Touching the mouse during a hands-off action stops it, and the shortcut Control-Option-Shift-Escape halts everything, with only the menu bar able to resume. Hazardous menu items such as Log Out and Empty Trash need on-screen approval.

For apps with weak accessibility support, OCR, UI detection and an optional vision model run locally. The tool is a menu bar app plus a CLI, and the CLI also serves MCP. It needs an Apple silicon Mac on macOS 26.5 or later.

## Features

- **Ghost input:** Sends input without moving your cursor or stealing focus.
- **Verified results:** Reports confirmed, noEffect or unverifiable for every action.
- **Status panel:** Shows the goal and current step in plain language.
- **Virtual display:** Moves a window to a temporary display for work, then restores it.
- **Checked plans:** Runs multi-step plans with checks and failure rules between steps.
- **Local screen recognition:** OCR, UI detection and an optional vision model run on the Mac.
- **Approval and stop:** On-screen approval for risky actions and a global emergency stop.

## Good for

- Automate a Mac app that has no API
- Test a native app's controls with proof of each result
- Keep working while an agent fills in forms in another app
- Drive apps with weak accessibility using on-device vision
- Run a checked multi-step workflow with pause points

## Install

### Claude Code (Terminal)

```sh
claude mcp add rocuronium -- npx -y https://github.com/kageroumado/rocuronium/releases/download/v1.6.2/rocuronium-1.6.2.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rocuronium": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kageroumado/rocuronium/releases/download/v1.6.2/rocuronium-1.6.2.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rocuronium": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kageroumado/rocuronium/releases/download/v1.6.2/rocuronium-1.6.2.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "rocuronium": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kageroumado/rocuronium/releases/download/v1.6.2/rocuronium-1.6.2.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rocuronium": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kageroumado/rocuronium/releases/download/v1.6.2/rocuronium-1.6.2.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rocuronium": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kageroumado/rocuronium/releases/download/v1.6.2/rocuronium-1.6.2.mcpb"
      ]
    }
  }
}
```

## FAQ

### What does it need to run?

An Apple silicon Mac on macOS 26.5 or later, with Accessibility permission and Screen Recording for screenshots and OCR.

### How do I install it?

Use brew install kageroumado/tap/rocuronium or download the disk image, then add it with claude mcp add rocuronium.

### How do I stop the agent?

Press Control-Option-Shift-Escape. Only the menu bar can resume, never the agent.

### Does screen data leave my Mac?

The site says OCR, detection and vision stay on your Mac, and input monitoring checks type and timing, never content.

### What is the licence?

MIT, and the app is free.

### Is Rocuronium free?

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

### How do I add Rocuronium to Claude Code?

Run this command in your terminal: claude mcp add rocuronium -- npx -y https://github.com/kageroumado/rocuronium/releases/download/v1.6.2/rocuronium-1.6.2.mcpb

### What are the best alternatives to Rocuronium?

The closest alternatives to Rocuronium 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.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.

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