Roam Tools
未认领Official MCP and CLI for Roam Research
01 / 选择客户端
03 / 添加配置
claude mcp add --transport stdio 'roam-tools' -- 'npx' '-y' '@roam-research/roam-mcp' 'connect'04 / 在客户端中确认
打开客户端的 MCP 设置，确认服务器已连接并列出工具。复制配置不代表连接成功。
更多Developer Tools服务器
浏览完整目录安全概况
已认领和已认证的服务器每周接受一次静态扫描，显示代码能触及的范围（外部服务、环境变量、shell 命令、代理配置目录）以及带有已知公告的依赖。认领此列表即可获得。 安全概况的工作原理
33 个工具中显示 33 个
文档中列出的工具 (33)
内容来自项目文档。服务器握手不会验证每个工具的说明或行为。
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