How do I connect Roam Tools MCP Server to Claude?

Run `claude mcp add roam-tools -- npx -y @roam-research/roam-mcp connect` 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 Tools MCP Server free?

MCPVault has not verified a licence for this server. Check the upstream terms and pricing before use; connected APIs may require a paid account.

What can Roam Tools MCP Server do?

Roam Tools MCP Server documents 33 tools to the agent, including add_comment, add_shortcut, append_to_daily_note. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Roam Tools

Unclaimed

by Roam-Research

Official MCP and CLI for Roam Research

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-tools' -- 'npx' '-y' '@roam-research/roam-mcp' 'connect'

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

33 of 33 tools

Documented tools (33)

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

add_comment

Add a comment to a block (comment thread, not child block)

add_shortcut

Add a page to the left sidebar Shortcuts / starred pages (optional index to position it)

append_to_daily_note

Append/capture markdown to a daily note (today by default, or MM-DD-YYYY / today/yesterday/tomorrow; optional nest-under section)

call_extension_tool

Invoke an AI tool registered by a Roam extension or roam/js script (discover available tools via the extensionTools field of getgraphguidelines)

create_block

Create blocks (by parent UID, page title, or daily note date — MM-DD-YYYY or today/yesterday/tomorrow; with optional nest-under)

create_page

Create page with markdown content

datalog_query

Execute a raw Datalog query against the graph's Datomic database

delete_block

Delete a block

delete_page

Delete a page

file_delete

Delete a file hosted on Roam

file_get

Fetch a file hosted on Roam (handles decryption for encrypted graphs)

file_upload

Upload a file to Roam (from local path, URL, or base64)

get_backlinks

Get references to a page/block

get_block

Get block content as markdown

get_comments

Get comments on a block with author/date context

get_graph_guidelines

Returns user-defined instructions and preferences for AI agents

get_open_windows

Main window view and all sidebar windows

get_page

Get page content as markdown

get_selection

Currently focused block and multi-selected blocks

list_graphs

List all configured graphs with their nicknames

move_block

Move a block to a new location

open_main_window

Navigate to page/block

open_sidebar

Open in right sidebar

reload_dev_extensions

Reload all developer-mode extensions in Roam Desktop (apply code changes without restarting)

remove_shortcut

Remove a page from the left sidebar Shortcuts / starred pages

roam_query

Execute a Roam query ({{query:}} blocks, not Datalog)

search

Search pages/blocks (empty query returns recently edited/viewed content)

search_templates

Search Roam templates by name

semantic_search

Semantic (embeddings) search by meaning; requires embeddings enabled and a signed-in user

setup_new_graph

Set up a new graph connection, or list available graphs

suggest_links

Suggest existing pages worth linking to from a passage of text (does not create links)

update_block

Update block content/properties

update_page

Update page title or children view type

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 Tools MCP Server

How do I connect Roam Tools MCP Server to Claude?: Run `claude mcp add roam-tools -- npx -y @roam-research/roam-mcp connect` 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 Tools MCP Server free?: MCPVault has not verified a licence for this server. Check the upstream terms and pricing before use; connected APIs may require a paid account.
What can Roam Tools MCP Server do?: Roam Tools MCP Server documents 33 tools to the agent, including add_comment, add_shortcut, append_to_daily_note. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.