MCP server and CLI for Roam Research
Roam Research MCP connects Roam Research MCP to AI assistants that speak the Model Context Protocol. MCP server and CLI for Roam Research.
I created this project to solve a personal problem: I wanted to manage my Roam Research graph directly from Claude Code (and other LLMs). As I built the Model Context Protocol (MCP) server to give AI agents access to my notes, I realized the underlying tools were powerful enough to stand on their own.
Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| roam_fetch_page_by_title | Fetch page content by title. |
| roam_fetch_page_full_view | Fetch a page's content plus all linked references with breadcrumb context and children. |
| roam_fetch_block | Fetch a block by UID with optional children (depth) and/or ancestors (up to page root). |
| roam_create_page | Create new pages, optionally with mixed text and table content. |
| roam_update_page_markdown | Update a page using smart diff (preserves block UIDs). |
| roam_get_subpages | List sub-pages under a namespace prefix (e.g. "Project/") with optional tag filter. |
| roam_search_by_text | Full-text search across the graph or within specific pages. Supports namespace prefix search for page titles. |
| roam_search_block_refs | Find blocks that reference a page, tag, or block UID. |
| roam_search_by_status | Find TODO or DONE items. |
| roam_search_for_tag | Find blocks containing specific tags (supports exclusion). |
| roam_search_by_date | Find blocks/pages by creation or modification date. |
| roam_find_pages_modified_today | List pages modified since midnight. |
| roam_add_todo | Add TODO items to today's daily page. |
| roam_create_table | Create properly formatted Roam tables. |
{
"mcpServers": {
"roam-research": {
"command": "npx",
"args": ["-y", "roam-research-mcp"],
"env": {
"ROAM_API_TOKEN": "your-token",
"ROAM_GRAPH_NAME": "your-graph"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| ROAM_API_TOKEN | Credential the server authenticates with. | Yes |
| ROAM_GRAPH_NAME | Configuration value read at startup. | Optional |
| ROAM_GRAPHS | Configuration value read at startup. | Optional |
| ROAM_DEFAULT_GRAPH | Configuration value read at startup. | Optional |
| ROAM_SYSTEM_WRITE_KEY | Credential the server authenticates with. | Yes |
| HTTP_STREAM_HOST | Endpoint or connection string the server talks to. | Optional |
| HTTP_AUTH_TOKEN | Credential the server authenticates with. | Yes |
Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.
Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.
<h1 style="font-size: 4.2em;">🌀 FluidMCP CLI</h1> <strong>Orchestrate multiple MCP servers with a single configuration file</strong>
Provides HTTP access to Multiple Command Protocol (MCP) tools via a REST API.
MCP server for Gotify push notifications - send messages and manage apps/clients.
Ask your security cameras anything and set up alert rules in a sentence. Built into Agent DVR.