Back to Home
2b3pro icon

roam-research-mcp

Verified Safe

by 2b3pro

Overview

Manages a Roam Research knowledge graph via CLI and exposes its functionalities as tools for AI agents (like Claude) to read, write, and organize notes.

Installation

Run Command
node build/index.js

Environment Variables

  • ROAM_API_TOKEN
  • ROAM_GRAPH_NAME
  • ROAM_GRAPHS
  • ROAM_DEFAULT_GRAPH
  • ROAM_SYSTEM_WRITE_KEY
  • ROAM_MEMORIES_TAG
  • HTTP_STREAM_PORT
  • CORS_ORIGINS
  • CUSTOM_INSTRUCTIONS_PATH

Security Notes

The `roam_datomic_query` tool allows execution of arbitrary Datalog queries, which poses a significant risk if the Roam API token has broad permissions, as it can potentially read or modify any data without further validation. There is a potential ReDoS (Regular Expression Denial of Service) vector if a malicious regex pattern is provided to the `regexFilter` parameter within the `roam_datomic_query` tool. The CORS configuration in `src/config/environment.ts` can be a vulnerability if set to '*' in a production environment, allowing requests from any origin.

Similar Servers

Stats

Interest Score46
Security Score6
Cost ClassMedium
Avg Tokens750
Stars68
Forks19
Last Update2026-01-18

Tags

Roam ResearchKnowledge BaseLLM ToolsCLINote Management