How do I connect Roam Research MCP Server to Claude?

Run `claude mcp add roam-research-mcp -- npx -y roam-research-mcp` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Roam Research MCP Server free?

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Roam Research MCP Server do?

Roam Research MCP Server documents 20 tools to the agent, including roam_add_todo, roam_create_outline, roam_create_page. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Roam Research MCP

Unclaimed

by 2b3pro

MCP Server and CLI tool for Roam Research Graph Integration

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'roam-research-mcp' -- 'npx' '-y' 'roam-research-mcp'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

20 of 20 tools

Documented tools (20)

From project documentation. A server handshake does not verify each tool’s description or behavior.

roam_add_todo

Add TODO items to today's daily page.

roam_create_outline

Create hierarchical outlines.

roam_create_page

Create new pages, optionally with mixed text and table content.

roam_create_table

Create properly formatted Roam tables.

roam_datomic_query

Execute raw Datalog queries for advanced filtering.

roam_fetch_block

Fetch a block by UID with optional children (depth) and/or ancestors (up to page root).

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_find_pages_modified_today

List pages modified since midnight.

roam_get_guidelines

Retrieve this graph's user-defined agent conventions.

roam_get_subpages

List sub-pages under a namespace prefix (e.g. "Project/") with optional tag filter.

roam_markdown_cheatsheet

Retrieve the Roam-flavored markdown reference.

roam_move_block

Move a block to a new parent or position.

roam_process_batch_actions

Execute multiple low-level actions (create, move, update, delete) in one batch.

roam_search_block_refs

Find blocks that reference a page, tag, or block UID.

roam_search_by_date

Find blocks/pages by creation or modification date.

roam_search_by_status

Find TODO or DONE items.

roam_search_by_text

Full-text search across the graph or within specific pages. Supports namespace prefix search for page titles.

roam_search_for_tag

Find blocks containing specific tags (supports exclusion).

roam_update_page_markdown

Update a page using smart diff (preserves block UIDs).

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Roam Research MCP Server

How do I connect Roam Research MCP Server to Claude?: Run `claude mcp add roam-research-mcp -- npx -y roam-research-mcp` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Roam Research MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Roam Research MCP Server do?: Roam Research MCP Server documents 20 tools to the agent, including roam_add_todo, roam_create_outline, roam_create_page. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.