en es ja ko zh

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.

Integrations

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'"

Features

Content Creation

Create new pages with nested content
Add blocks to any page
Import markdown with proper nesting
Add todo items
Update existing content

Search and Retrieval

Find pages and blocks by title, text, or tags
Search for TODO/DONE items
Find recently modified content
Execute custom Datalog queries

Optional Memory System

Store information for Claude to remember across conversations
Recall stored memories with filtering options

URL Content Processing

Extract content from webpages, PDFs, and YouTube videos

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:

{
  "mcpServers": {
    "roam-helper": {
      "command": "uvx",
      "args": ["git+https://github.com/PhiloSolares/roam-mcp.git"],
      "env": {
        "ROAM_API_TOKEN": "<your_roam_api_token>",
        "ROAM_GRAPH_NAME": "<your_roam_graph_name>"
      }
    }
  }
}

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."

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?"

Advanced Configuration

By default, memories are stored with the tag #[[Memories]]. To use a different tag:

"env": {
  "ROAM_API_TOKEN": "your-token",
  "ROAM_GRAPH_NAME": "your-graph",
  "MEMORIES_TAG": "#[[Claude/Memories]]"
}

License

MIT License

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

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.