MCPVault

get_block

MCP tool from Roam Tools by Roam-Research

Get block content as markdown

How to use it

get_block is exposed by the Roam Tools MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the get_block tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install Roam Tools

$npx @roam-research/roam-mcp connect
FULL ROAM TOOLS LISTING

Other tools in Roam Tools (32)

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_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