📋

Roam Research MCP Server

Updated June 2026✓ Official

The Roam Research MCP server, built by Roam Research, provides the Roam Research MCP Server is the official, first-party Model Context Protocol server for Roam Research, published by the Roam Research team itself and covering the full read/write surface of your Roam graph. It is officially maintained and best for Productivity.

by Roam Research

About

The Roam Research MCP Server is the official, first-party Model Context Protocol server for Roam Research, published by the Roam Research team itself and covering the full read/write surface of your Roam graph. It connects to Roam's local HTTP API, which runs inside the Roam desktop app (not the web version) — if Roam isn't open when a tool is called, the server automatically launches it via deep link and retries. Setup runs through an interactive `connect` flow (`npx @roam-research/roam-mcp connect`) that walks you through selecting a graph, choosing an access level (full, read-append, or read-only), and approving a local API token inside Roam's Settings > Graph > Local API Tokens screen; a non-interactive flag-based mode is also available for scripted or agent-driven setup. Multiple graphs can be connected simultaneously, each addressable by a short nickname. The tool surface spans six areas: graph management (list_graphs, setup_new_graph), graph guidelines (get_graph_guidelines reads a special `[[roam/agent guidelines]]` page for user-defined AI instructions), content mutation (create/update/delete for pages and blocks, append_to_daily_note, move_block, add_comment/get_comments), read/search (search, roam_query for `{{query:}}` blocks, datalog_query for raw Datomic queries, get_page, get_block, get_backlinks), navigation (get_open_windows, get_selection, open_main_window, open_sidebar), and file handling (file_get/file_upload/file_delete, including encrypted-graph decryption). The README flags this as alpha software and explicitly warns that write operations are difficult or impossible to fully undo since Roam lacks bulk-operation undo history — back up your graph before granting full write access. A companion CLI (`@roam-research/roam-cli`) is available for terminal-driven graph interaction outside an MCP client. Works with Claude Desktop, Claude Code, Cursor, and any MCP-compatible client. Ideal for daily-note capture, backlink-driven knowledge retrieval, and agent-assisted graph restructuring for second-brain / networked-note workflows.

Installation

npm / npx
npx @roam-research/roam-mcp connect

Frequently Asked Questions

What is Roam Research MCP Server?
Roam Research is an MCP server built by Roam Research. The Roam Research MCP Server is the official, first-party Model Context Protocol server for Roam Research, published by the Roam Research team itself and covering the full read/write surface of your Roam graph. It connects to Roam's local HTTP API, which runs inside the Roam desktop app (not the web version) — if Roam isn't open when a tool is called, the server automatically launches it via deep link and retries. Setup runs through an interactive `connect` flow (`npx @roam-research/roam-mcp connect`) that walks you through selecting a graph, choosing an access level (full, read-append, or read-only), and approving a local API token inside Roam's Settings > Graph > Local API Tokens screen; a non-interactive flag-based mode is also available for scripted or agent-driven setup. Multiple graphs can be connected simultaneously, each addressable by a short nickname. The tool surface spans six areas: graph management (list_graphs, setup_new_graph), graph guidelines (get_graph_guidelines reads a special `[[roam/agent guidelines]]` page for user-defined AI instructions), content mutation (create/update/delete for pages and blocks, append_to_daily_note, move_block, add_comment/get_comments), read/search (search, roam_query for `{{query:}}` blocks, datalog_query for raw Datomic queries, get_page, get_block, get_backlinks), navigation (get_open_windows, get_selection, open_main_window, open_sidebar), and file handling (file_get/file_upload/file_delete, including encrypted-graph decryption). The README flags this as alpha software and explicitly warns that write operations are difficult or impossible to fully undo since Roam lacks bulk-operation undo history — back up your graph before granting full write access. A companion CLI (`@roam-research/roam-cli`) is available for terminal-driven graph interaction outside an MCP client. Works with Claude Desktop, Claude Code, Cursor, and any MCP-compatible client. Ideal for daily-note capture, backlink-driven knowledge retrieval, and agent-assisted graph restructuring for second-brain / networked-note workflows.
Who built Roam Research MCP Server?
Roam Research MCP Server was built by Roam Research.
Is Roam Research MCP Server free?
Roam Research is free to install as an MCP server, but the underlying service may require payment. The MCP server is free and open-source. Roam Research: Pro: $15/mo or $165/year. Believer: $500 for 5 years.
How do I install Roam Research MCP Server?
Install Roam Research MCP Server with npm: npx @roam-research/roam-mcp connect
What does Roam Research MCP Server integrate with?
Roam Research MCP Server integrates with Claude Desktop, Cursor, VS Code, Windsurf, Cline.

Repo Health

Local install

Local/stdio install — runs on your machine, so there is no remote endpoint to verify live. Trust signal below is from the source repo.

Repo recency not yet available for this server.

Quick Info

Install Type
npm
Author
Roam Research
Categories
2
Integrations
5

Related Servers

🧠

Memory

Knowledge graph-based persistent memory system. Store and retrieve contextual information.

Local
📋

Time

Time and timezone conversion capabilities for AI assistants.

Local
💻

21st.dev Magic

Create crafted UI components inspired by the best 21st.dev design engineers.

Local
📋

Notion MCP Server

The Notion MCP Server is the official integration from Notion that connects AI assistants directly to your Notion workspace via the Notion REST API. With 3,500+ GitHub stars, it is the canonical MCP tool for bringing Notion's knowledge management capabilities into Claude Desktop, Cursor, Windsurf, and any MCP-compatible client. The server exposes a rich set of tools: search your entire workspace by keyword and return matching pages and databases; retrieve full page content and block trees; create new pages inside any parent page or workspace section; update, append, or delete block content on existing pages; list all databases your integration has access to; query database entries with filter and sort parameters; retrieve individual blocks or nested children by block ID; and add comments to pages. Authentication uses a Notion integration token — create an internal integration at notion.so/my-integrations, share specific pages or databases with it, and set NOTION_API_KEY in your environment. Install with a single npx command. The Notion MCP Server is especially powerful for AI workflows that span documentation retrieval, project planning, and knowledge capture — Claude can read product specs from Notion, draft new pages from conversation output, log structured data into databases, and search across thousands of notes without any manual copy-paste.

Auth required
📋

Linear MCP Server

The Linear MCP server connects your AI assistant directly to Linear's project management platform via an officially hosted remote endpoint at mcp.linear.app — no local installation required. This is Linear's own first-party server, authenticated with OAuth 2.1 and centrally managed so you always run the latest version without updates. Available tools let you search issues by keyword, team, cycle, or filter; create new issues with title, description, and assignee; update status, priority, labels, and comments; and navigate Linear's project and cycle structure. In Claude Code, add it with: `claude mcp add --transport http linear-server https://mcp.linear.app/mcp`, then run /mcp to complete the OAuth flow. For older clients, use the mcp-remote bridge for backwards compatibility. Claude Desktop and Claude.ai users can connect via Settings > Connectors. Cursor and Codex have native support via their MCP config. Linear is used by thousands of engineering and product teams to plan, track, and ship software — the Linear MCP server brings that data into every AI-powered workflow without copy-paste or context-switching.

Auth required

Sponsored

Gamma

Free Plan

AI-native presentation and document builder. Instantly transform your agent's content into shareable slides, docs, or webpages.

Try Gamma free →