# RoadRaven

Wires your agent into the RoadRaven desktop app so it can read the open roadmap, edit nodes and keep statuses current as work moves.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: Shuffzord
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Shuffzord/RoadRaven/tree/HEAD/plugins/claude-code
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/roadraven

## What it does

RoadRaven is a local desktop app that draws a project plan as a tree and keeps it up to date while the work happens. The MCP server hands an agent 21 tools: read the open roadmap, add a node, change it, move it, remove it, set its status. A Claude plugin adds two skills that spell out how to use those tools for planning and doing the work.

The app has to be running. Every tool reaches it over a local connection on `127.0.0.1`. With the app closed you get `app_not_running`; with nothing open, `no_file_loaded`. Files are only opened or saved where you already work, so asking for another path returns `path_not_permitted`. The server reads a single file, `event-api.json` in RoadRaven's user-data folder (`~/.config/RoadRaven` on Linux, `%LOCALAPPDATA%\RoadRaven` on Windows), where the app stores its local port. Nothing goes anywhere else and no telemetry is collected.

The skills come only with the Claude plugin install. The Setup Wizard and the `npx` route give you the tools without them. Both skills pick up your test, lint and build commands from the project README, package manifest or CI config, so the language does not matter. The server writes files only when you run `npx @roadraven/mcp init` yourself: it offers to add a short RoadRaven section to a `CLAUDE.md` and asks first.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add roadraven -- npx -y @roadraven/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add claude-code -- npx -y @roadraven/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "claude-code": {
            "command": "npx",
            "args": [
                "-y",
                "@roadraven/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "claude-code": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@roadraven/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add claude-code npx -y @roadraven/mcp
```

## When to use it
- turn a request into a tree of goals, phases and tasks
- keep node statuses current while work runs
- hand a phase to a sub-agent and check the result
- record progress on a task in the node's notes
- match a change against the project's test and build commands

## Example prompts
- Plan the CSV export feature as a roadmap in RoadRaven and run it phase by phase.
- Break the release into phases, write a brief for each, and run them one after another.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md