Ritoko
Save browser, API and MCP workflows and run CSV or Excel batches with resume
- 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 ritokoAdd to claude_desktop_config.json
{
"mcpServers": {
"ritoko": {
"command": "npx",
"args": [
"-y",
"ritoko"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ritoko": {
"command": "npx",
"args": [
"-y",
"ritoko"
]
}
}
}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

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP 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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

Oya Browser
MCP serverHIPAA-oriented agentic browser with replayable playbooks, reachable over MCP
- 32 tools
- Remote
- Freemium
- 349 GitHub stars
- Browser automation
Mantis
MCP serverBrowser MCP server that gives agents numbered text pages instead of screenshots
Runs locally- 1 tool
- Open source
- 5 Hacker News points
- Browser automation