Roam Tools
未认领Official MCP and CLI for Roam Research
安装
npx @roam-research/roam-mcp connect工具（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