Skip to content
MCP server

Ritoko

Save browser, API and MCP workflows and run CSV or Excel batches with resume

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.0
Listing updated
1 day ago

About Ritoko

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

Ritoko turns a task an agent solved once into a saved procedure that can be replayed over a spreadsheet. Workflows are readable JSON files holding parameters, selectors, API calls and checks, and a local SQLite journal records which rows finished, failed or ended with an uncertain outcome.

On a rerun, confirmed rows are skipped and uncertain writes are held for review. Version 0.2.0 adds configurable ensure lookups that check before creating a record and reconcile lookups that settle an uncertain write by reading it back, using a direct HTTP GET or an explicitly read-only MCP tool. The README says the journal does not guarantee duplicates are impossible.

The direct replay engine makes no model calls, though recording and repair or connected tools may. It runs as a Claude Code or Codex plugin, a stdio MCP server or a CLI, needs Node.js 24+, and is MIT licensed.

Install

Run in a terminal

claude mcp add ritoko -- npx -y ritoko

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ritoko": {
      "command": "npx",
      "args": [
        "-y",
        "ritoko"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ritoko": {
      "command": "npx",
      "args": [
        "-y",
        "ritoko"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ritoko": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ritoko"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "ritoko": {
      "command": "npx",
      "args": [
        "-y",
        "ritoko"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "ritoko": {
      "command": "npx",
      "args": [
        "-y",
        "ritoko"
      ]
    }
  }
}

What it does

Saved workflows
Stores steps, selectors, API calls and checks as JSON.
Batch input
Feeds CSV or Excel rows through the same procedure.
Resume journal
A SQLite journal skips confirmed rows and holds uncertain ones.
Ensure and reconcile
Looks up a record before creating it or after an uncertain write.
No-LLM replay
Direct replay runs without model calls.
Mixed steps
Combines browser, HTTP and MCP tool steps.

Good for

  • Create customers from a CSV in a web form
  • Download monthly report exports
  • Update a list of records via an API
  • Extract a rendered table to CSV

Pricing

Open source

Free and open source under the MIT licence

Prices change. Check ritoko.com before you buy.

Ritoko FAQ

Does it need an AI model on every run?

No. The direct replay engine does not call an LLM, though recording, repair and external tools may.

What happens if a run is interrupted?

Finished rows are kept and uncertain submissions are held for review.

Which Node.js version is needed?

Node.js 24 or newer.

What is the licence?

MIT.

Is Ritoko free?

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

How do I add Ritoko to Claude Code?

Run this command in your terminal: claude mcp add ritoko -- npx -y ritoko

What are the best alternatives to Ritoko?

The closest alternatives to Ritoko are Browser Use, Scrapling MCP Server, Ha MCP, Concord MCP and Oya Browser.

Alternatives to Ritoko

  1. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  2. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  3. 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
  4. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  5. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  6. Mantis

    MCP server

    Browser MCP server that gives agents numbered text pages instead of screenshots

    Runs locally
    • 1 tool
    • Open source
    • 5 Hacker News points
    • Browser automation