Roam Research MCP

Name: Roam Research MCP
Author: 2b3pro

2b3pro

Get started Repository

MCP server and CLI that let agents read and write a Roam Research graph through its API.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add roam-research --env MEMORIES_TAG='<MEMORIES_TAG>' --env ROAM_API_TOKEN='<ROAM_API_TOKEN>' --env ROAM_GRAPH_NAME='<ROAM_GRAPH_NAME>' -- npx roam-research-mcp

~/.codex/config.toml

[mcp_servers.roam-research]
command = "npx"
args = ["roam-research-mcp"]
env = { MEMORIES_TAG = "<MEMORIES_TAG>", ROAM_API_TOKEN = "<ROAM_API_TOKEN>", ROAM_GRAPH_NAME = "<ROAM_GRAPH_NAME>" }

# codex mcp add roam-research --env MEMORIES_TAG='<MEMORIES_TAG>' --env ROAM_API_TOKEN='<ROAM_API_TOKEN>' --env ROAM_GRAPH_NAME='<ROAM_GRAPH_NAME>' -- npx roam-research-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "roam-research": {
      "command": "npx",
      "args": [
        "roam-research-mcp"
      ],
      "env": {
        "MEMORIES_TAG": "<MEMORIES_TAG>",
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>",
        "ROAM_GRAPH_NAME": "<ROAM_GRAPH_NAME>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "roam-research": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "roam-research-mcp"
      ],
      "env": {
        "MEMORIES_TAG": "<MEMORIES_TAG>",
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>",
        "ROAM_GRAPH_NAME": "<ROAM_GRAPH_NAME>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "roam-research": {
      "command": "npx",
      "args": [
        "roam-research-mcp"
      ],
      "env": {
        "MEMORIES_TAG": "<MEMORIES_TAG>",
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>",
        "ROAM_GRAPH_NAME": "<ROAM_GRAPH_NAME>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "roam-research": {
      "command": "npx",
      "args": [
        "roam-research-mcp"
      ],
      "env": {
        "MEMORIES_TAG": "<MEMORIES_TAG>",
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>",
        "ROAM_GRAPH_NAME": "<ROAM_GRAPH_NAME>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "roam-research": {
      "command": "npx",
      "args": [
        "roam-research-mcp"
      ],
      "env": {
        "MEMORIES_TAG": "<MEMORIES_TAG>",
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>",
        "ROAM_GRAPH_NAME": "<ROAM_GRAPH_NAME>"
      }
    }
  }
}

Environment variables

MEMORIES_TAG
ROAM_API_TOKEN
ROAM_GRAPH_NAME

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related