Roam Research MCP Server

A Model Context Protocol (MCP) server that provides tools to interact with Roam Research API, enabling Claude Desktop to read from and write to your Roam Research graph.

Features

Get Page Content: Retrieve content from any page with nested child blocks in markdown format
Get Page References: Find all references to a specific page with pagination support and time-based sorting
Write to Page: Add new blocks to existing pages
Write to Today: Add content to today's daily page (auto-creates if needed)
Markdown Conversion: Automatically converts Roam-style [[links]] to markdown format
Nested Block Support: Handles hierarchical block structures with proper indentation

Installation

Prerequisites

Python 3.11+
uv package manager
Roam Research API token and graph access

Setup

Clone the repository:

git clone <repository-url>
cd roam-research-mcp

Install dependencies:

uv sync

Set up environment variables:

export ROAM_TOKEN="your_roam_research_api_token"
export ROAM_GRAPH_NAME="your_graph_name"

Claude Desktop Integration

Add this configuration to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "roam-research": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/roam-research-mcp",
        "run",
        "python",
        "main.py"
      ],
      "env": {
        "ROAM_TOKEN": "your_actual_roam_token",
        "ROAM_GRAPH_NAME": "your_graph_name"
      }
    }
  }
}

Usage

Once configured with Claude Desktop, you can:

Ask Claude to read content from your Roam pages
Have Claude write notes and thoughts to your daily pages
Query page references and connections
Add structured content to specific pages

Development

See CLAUDE.md for development guidelines and git commit conventions.

API Requirements

Valid Roam Research API token
Graph name with API access enabled
Network access to api.roamresearch.com

License

MIT License

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

Tools

A Model Context Protocol server that enables Claude Desktop to read from and write to Roam Research graphs, allowing for retrieving page content, finding references, and adding blocks to existing or daily pages.

Related MCP Servers

MCP Memory Server
ebailey78
-
security
F
license
-
quality
A Model Context Protocol server for Claude Desktop that provides structured memory management across chat sessions, allowing Claude to maintain context and build a knowledge base within project directories.
Last updated -
3
Claude TypeScript MCP Servers
ukkz
A
security
A
license
A
quality
A collection of Model Context Protocol servers that enable Claude Desktop to provide development assistance capabilities with filesystem, Git, shell command, and web search functionality without incurring API usage costs.
Last updated -
2
19
MIT License
MCP Deep Web Research Server
PedroDnT
A
security
A
license
A
quality
A Model Context Protocol server that enables Claude to perform advanced web research with intelligent search queuing, enhanced content extraction, and deep research capabilities.
Last updated -
3
12
1
MIT License
302AI BrowserUse MCP Serverofficial
302ai
A
security
A
license
A
quality
A Model Context Protocol server that enables Claude Desktop to browse the web, likely allowing the AI to access and interact with web content.
Last updated -
2
7
5
MIT License

View all related MCP servers

Roam Research MCP Server