Roam MCP

Name: Roam MCP
Author: PhiloSolares

PhiloSolares

Get started Repository

Connects AI assistants to a Roam Research graph to read and write notes.

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-philosolares --env ROAM_API_TOKEN='<ROAM_API_TOKEN>' --env ROAM_GRAPH_NAME='<ROAM_GRAPH_NAME>' -- uvx git+https://github.com/PhiloSolares/roam-mcp.git

~/.codex/config.toml

[mcp_servers.roam-philosolares]
command = "uvx"
args = ["git+https://github.com/PhiloSolares/roam-mcp.git"]
env = { ROAM_API_TOKEN = "<ROAM_API_TOKEN>", ROAM_GRAPH_NAME = "<ROAM_GRAPH_NAME>" }

# codex mcp add roam-philosolares --env ROAM_API_TOKEN='<ROAM_API_TOKEN>' --env ROAM_GRAPH_NAME='<ROAM_GRAPH_NAME>' -- uvx git+https://github.com/PhiloSolares/roam-mcp.git

~/.cursor/mcp.json

{
  "mcpServers": {
    "roam-philosolares": {
      "command": "uvx",
      "args": [
        "git+https://github.com/PhiloSolares/roam-mcp.git"
      ],
      "env": {
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>",
        "ROAM_GRAPH_NAME": "<ROAM_GRAPH_NAME>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "roam-philosolares": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "git+https://github.com/PhiloSolares/roam-mcp.git"
      ],
      "env": {
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>",
        "ROAM_GRAPH_NAME": "<ROAM_GRAPH_NAME>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "roam-philosolares": {
      "command": "uvx",
      "args": [
        "git+https://github.com/PhiloSolares/roam-mcp.git"
      ],
      "env": {
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>",
        "ROAM_GRAPH_NAME": "<ROAM_GRAPH_NAME>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "roam-philosolares": {
      "command": "uvx",
      "args": [
        "git+https://github.com/PhiloSolares/roam-mcp.git"
      ],
      "env": {
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>",
        "ROAM_GRAPH_NAME": "<ROAM_GRAPH_NAME>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "roam-philosolares": {
      "command": "uvx",
      "args": [
        "git+https://github.com/PhiloSolares/roam-mcp.git"
      ],
      "env": {
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>",
        "ROAM_GRAPH_NAME": "<ROAM_GRAPH_NAME>"
      }
    }
  }
}

Environment variables

ROAM_API_TOKEN
ROAM_GRAPH_NAME

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

Setup

Environment variables

Related