search
Search pages/blocks (empty query returns recently edited/viewed content)
How to use it
search is exposed by the Roam Tools MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the search 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 connectOther tools in Roam Tools (32)
Add a comment to a block (comment thread, not child block)
Add a page to the left sidebar Shortcuts / starred pages (optional index to position it)
Append/capture markdown to a daily note (today by default, or MM-DD-YYYY / today/yesterday/tomorrow; optional nest-under section)
Invoke an AI tool registered by a Roam extension or roam/js script (discover available tools via the extensionTools field of getgraphguidelines)
Create blocks (by parent UID, page title, or daily note date — MM-DD-YYYY or today/yesterday/tomorrow; with optional nest-under)
Create page with markdown content
Execute a raw Datalog query against the graph's Datomic database
Delete a block
Delete a page
Delete a file hosted on Roam
Fetch a file hosted on Roam (handles decryption for encrypted graphs)
Upload a file to Roam (from local path, URL, or base64)
Get references to a page/block
Get block content as markdown
Get comments on a block with author/date context
Returns user-defined instructions and preferences for AI agents
Main window view and all sidebar windows
Get page content as markdown
Currently focused block and multi-selected blocks
List all configured graphs with their nicknames
Move a block to a new location
Navigate to page/block
Open in right sidebar
Reload all developer-mode extensions in Roam Desktop (apply code changes without restarting)
Remove a page from the left sidebar Shortcuts / starred pages
Execute a Roam query ({{query:}} blocks, not Datalog)
Search Roam templates by name
Semantic (embeddings) search by meaning; requires embeddings enabled and a signed-in user
Set up a new graph connection, or list available graphs
Suggest existing pages worth linking to from a passage of text (does not create links)
Update block content/properties
Update page title or children view type