Skip to content
MCP server

Rocuronium

Let an agent click and type in Mac apps while you keep using your cursor

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

About Rocuronium

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

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "rocuronium": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kageroumado/rocuronium/releases/download/v1.6.2/rocuronium-1.6.2.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "rocuronium": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kageroumado/rocuronium/releases/download/v1.6.2/rocuronium-1.6.2.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

What it does

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

Pricing

Open source

Free, MIT licence

Prices change. Check kagerou.glass before you buy.

Rocuronium 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 to Rocuronium

  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. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity