Roam Research

by philosolares

Not rated
GitHub

About

Connects AI assistants to your Roam Research graph for data access and interaction.

Details

Author
philosolares
Categories
Productivity, Other, Knowledge Base, Database

Setup

Install Roam Research in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/philosolares/roam-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

A Model Context Protocol (MCP) server that connects Claude and other AI assistants to your Roam Research graph.

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.

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

- 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

- 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

- 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

- Extract and import content from webpages
- Parse and extract text from PDF documents
- Retrieve YouTube video transcripts
- Intelligently detect content type and process accordingly
- Install Claude Desktop fromhttps://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

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

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.

You: "Claude, please create a new page in my Roam graph called 'Project Ideas' with a section for mobile app ideas."

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

You: "Remember that I want to use spaced repetition for learning JavaScript."

Later: You: "What learning techniques have we discussed for programming?"

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

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]]" }

You can run the Roam MCP server in a Docker container:

docker run -p 3000:3000 \ -e ROAM_API_TOKEN="your_api_token" \ -e ROAM_GRAPH_NAME="your_graph_name" \ roam-mcp

Configure Claude Desktop to use the containerized server:

{ "mcpServers": { "roam-helper": { "command": "docker", "args": ["run", "--rm", "-p", "3000:3000", "-e", "ROAM_API_TOKEN=your_token", "-e", "ROAM_GRAPH_NAME=your_graph", "roam-mcp"], "env": {} } } }

Create notes, search, & think with your Fabric AI workspace

Interact with your Anytype data through its API, enabling AI assistants to access your information.

MCP server for Apple Notes with semantic search and CRUD operations. Claude searches, reads, creates, updates, and manages your Apple Notes through natural language.

Access and manage your Bear Notes from a local SQLite database.

Personal Knowledge Base MCP — 22 tools for AI agents to access your curated reading intelligence.

Integrates Model Context Protocol (MCP) with Obsidian, allowing AI assistants to interact with your notes and vault.

The visual deal tracker for AI agents to search pipelines, log notes, qualify leads, and export live reports.

Create notes in Flomo through AI chat interactions in Cursor or Claude desktop.

Manage and share personal knowledge, daily notes, and reusable prompts using GitHub Gists.

Historis keeps track of what happened — so you and your AI are never out of sync. Everything lands in one shared timeline, linked to the right people. Ask for the brief: what happened, what you should know, what needs handling.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.