Supports importing nested markdown content with proper conversion into Roam Research's structure
Provides comprehensive access to Roam Research's API including creating pages and blocks, manipulating content, searching, retrieving information with custom queries, and an optional memory system for storing important information
Enables fetching transcripts from YouTube videos to incorporate into Roam Research pages
Roam Research MCP Server
A Model Context Protocol (MCP) server that connects Claude and other AI assistants to your Roam Research graph.
What This Does
This server acts as a bridge between AI assistants and your Roam Research database. After setup, you can simply ask Claude to work with your Roam data - no coding required.
For example, you can say:
"Add these meeting notes to today's daily note in Roam"
"Search my Roam graph for blocks tagged with #ProjectIdeas"
"Create a new page in Roam called 'Project Planning'"
"Find all TODO items I created this month"
Features
Content Creation
Create new pages with nested content and headings
Add blocks to any page with proper hierarchy
Create structured outlines with customizable nesting
Import markdown with proper nesting
Add todo items with automatic TODO status
Update existing content individually or in batches
Modify block content with pattern transformations
Search and Retrieval
Find pages and blocks by title, text, or tags
Search for TODO/DONE items with filtering options
Find recently modified content
Search block references and explore block hierarchies
Search by creation or modification dates
Navigate parent-child relationships in blocks
Execute custom Datalog queries for advanced needs
Memory System
Store information for Claude to remember across conversations
Recall stored memories with filtering and sorting options
Tag memories with custom categories
Access both recent and older memories with flexible retrieval
URL Content Processing
Extract and import content from webpages
Parse and extract text from PDF documents
Retrieve YouTube video transcripts
Intelligently detect content type and process accordingly
Setup Instructions
Install Claude Desktop from https://claude.ai/download
Edit your Claude Desktop configuration file:
Mac:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add this configuration:
Get your Roam API token:
Go to your Roam Research graph settings
Navigate to "API tokens"
Click "+ New API Token"
Copy the token to your configuration
How to Use
Once set up, simply chat with Claude and ask it to work with your Roam graph. Claude will use the appropriate MCP commands behind the scenes.
Example conversations:
Creating Content:
You: "Claude, please create a new page in my Roam graph called 'Project Ideas' with a section for mobile app ideas."
Searching Content:
You: "Find all blocks in my Roam graph tagged with #ProjectIdeas that also mention mobile apps."
You: "Show me all the TODO items I created this week."
Using the Memory System:
You: "Remember that I want to use spaced repetition for learning JavaScript."
Later: You: "What learning techniques have we discussed for programming?"
Working with External Content:
You: "Extract the main points from this PDF and add them to my Roam graph."
You: "Get the transcript from this YouTube video about productivity."
Advanced Configuration
By default, memories are stored with the tag #[[Memories]]
. To use a different tag:
Docker Support
You can run the Roam MCP server in a Docker container:
Building the Image
Running the Container
Run with environment variables:
Using with Claude Desktop
Configure Claude Desktop to use the containerized server:
License
MIT License
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A server that enables AI assistants like Claude to interact with Roam Research graphs through a standardized interface, providing comprehensive tools for content creation, search, retrieval, and optional memory management.
Related MCP Servers
- AsecurityAlicenseAqualityProvides comprehensive access to Roam Research's API functionality. This server enables AI assistants like Claude to interact with your Roam Research graph through a standardized interface.Last updated -1466MIT License
- -securityAlicense-qualityA modular server implementation for Claude AI assistants with integrated tools, enabling Claude to perform actions and access external resources like file systems, web searches, browser automation, financial data, and document generation.Last updated -98MIT License
- -securityFlicense-qualityThis server enables AI assistants (CLINE, Cursor, Windsurf, Claude Desktop) to share a common knowledge base through Retrieval Augmented Generation (RAG), providing consistent information access across multiple tools.Last updated -4
- AsecurityFlicenseAqualityA powerful research assistant that conducts intelligent, iterative research through web searches, analysis, and comprehensive report generation on any topic.Last updated -423