Overview

The roam-sdk includes a built-in Model Context Protocol (MCP) server that exposes your Roam graph to AI assistants like Claude, Cursor, and other MCP-compatible clients.

Features

• 18 tools covering read, write, search, and export operations

• Runs over stdio transport — works with any MCP client

• Batch writes — execute multiple operations in a single API call

• Full-text search — search inside block content, not just page titles

• Daily note access — retrieve notes by date or today's note

• Markdown export — convert pages to clean markdown

• Graph statistics — page and block counts at a glance

Quick start

# Run directly
roam --mcp

# Or via npx (no install needed)
npx roam-tui@latest --mcp

The server reads config from ~/.config/roam-tui/config.toml or environment variables.

Next steps

• Setup & Configuration — configure your MCP client

• Tools Reference — all 18 tools with parameters and examples