Roam TUI

What it does

Connects AI assistants directly to your Roam Research cloud API, allowing them to navigate, search, and edit your personal knowledge graph without needing a browser.

Tools

• search: Find pages by their title.
• search_blocks: Perform full-text searches across all block content.
• get_page: Retrieve a full page including all nested blocks.
• get_block: Fetch a specific block using its unique UID.
• get_daily_note: Access daily notes based on a specific date.
• get_backlinks: Discover all blocks that reference a particular page.
• get_block_refs: Extract outbound references from a specific block.
• get_graph_stats: Get high-level statistics on page and block counts.
• roam_query: Execute raw Datalog queries for complex data retrieval.
• create_page: Generate new pages in the graph.
• create_block: Add new content blocks under a parent block.
• create_block_with_children: Create complex nested block structures.
• update_block: Modify existing block content.
• delete_block: Remove a block from the graph.
• delete_page: Remove an entire page.
• move_block: Relocate a block to a different parent.
• batch_write: Execute multiple write operations in a single call.
• export_page_as_markdown: Convert a Roam page into formatted markdown.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "roam": {
      "command": "npx",
      "args": ["-y", "roam-tui@latest", "--mcp"],
      "env": {
        "ROAM_GRAPH_NAME": "your-graph-name",
        "ROAM_GRAPH_API__TOKEN": "roam-graph-token-XXXXX"
      }
    }
  }
}

Supported hosts

• Claude Desktop
• Cursor