open_main_window
Navigate to page/block
How to use it
open_main_window is exposed by the Roam Tools MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the open_main_window 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
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 pages/blocks (empty query returns recently edited/viewed content)
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