Skip to main content
Glama

Roam Research MCP Server

by mickm3n
GitHub
Python
1
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

  1. Clone the repository:

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

  1. Install dependencies:

uv sync

  1. 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
A
security – no known vulnerabilities
F
license - not found
A
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.

  1. Features
    1. Installation
      1. Prerequisites
      2. Setup
    2. Claude Desktop Integration
      1. Usage
        1. Development
          1. API Requirements
            1. License

              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
                • Apple

              • 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
                7
                1
                MIT License
                • Apple

              • 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
                17
                5
                MIT License
                • Apple

              View all related MCP servers

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/mickm3n/roam-research-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server