# Ritoko

> Ritoko is an open-source MCP server for files and documents. Save browser, API and MCP workflows and run CSV or Excel batches with resume. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://ritoko.com
- **Repository:** https://github.com/swih/ritoko
- **MCP Registry name:** io.github.Swih/ritoko
- **Categories:** files and documents, browser automation, productivity
- **Listing updated:** 2026-11-16

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add ritoko -- npx -y ritoko
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

```json
{
  "mcpServers": {
    "ritoko": {
      "command": "npx",
      "args": [
        "-y",
        "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

- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source MCP server for browser automation.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.

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