Knowledge Management · Developer Tools

Roam Research MCP logo

Roam Research MCP

2b3pro/roam-research-mcp

What started as an backend for AI agents evolved into a full-featured Standalone CLI. Now, you can use the same powerful API capabilities directly from your terminal—piping content into Roam, searching your graph, and managing tasks—without needing an LLM at all.

Install

npx -y roam-research-mcp

Client configuration

{
  "mcpServers": {
    "roam-research": {
      "command": "npx",
      "args": [
        "-y",
        "roam-research-mcp"
      ],
      "env": {
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>",
        "ROAM_GRAPH_NAME": "<ROAM_GRAPH_NAME>"
      }
    }
  }
}

Environment variables

ROAM_API_TOKENROAM_GRAPH_NAMEROAM_GRAPHSROAM_DEFAULT_GRAPHROAM_SYSTEM_WRITE_KEYROAM_GUIDELINES_PAGEHTTP_AUTH_TOKEN
GitHub stars
38
Author
@2b3pro
Category
Knowledge Management, Developer Tools
License
MIT
Updated
Oct 6, 2026

About Roam Research MCP

I created this project to solve a personal problem: I wanted to manage my Roam Research graph directly from Claude Code (and other LLMs). As I built the Model Context Protocol (MCP) server to give AI agents access to my notes, I realized the underlying tools were powerful enough to stand on their own.

Tools (21)

  • roam_fetch_page_by_title

    Fetch page content by title.

  • roam_fetch_page_full_view

    Fetch a page's content plus all linked references with breadcrumb context and children.

  • roam_fetch_block

    Fetch a block by UID with optional children (depth) and/or ancestors (up to page root).

  • roam_create_page

    Create new pages, optionally with mixed text and table content.

  • roam_update_page_markdown

    Update a page using smart diff (preserves block UIDs).

  • roam_get_subpages

    List sub-pages under a namespace prefix (e.g.

  • roam_search_by_text

    Full-text search across the graph or within specific pages.

  • roam_search_block_refs

    Find blocks that reference a page, tag, or block UID.

  • roam_search_by_status

    Find TODO or DONE items.

  • roam_search_for_tag

    Find blocks containing specific tags (supports exclusion).

  • roam_search_by_date

    Find blocks/pages by creation or modification date.

  • roam_find_pages_modified_today

    List pages modified since midnight.

  • roam_add_todo

    Add TODO items to today's daily page.

  • roam_create_table

    Create properly formatted Roam tables.

  • roam_create_outline

    Create hierarchical outlines.

  • roam_process_batch_actions

    Execute multiple low-level actions (create, move, update, delete) in one batch.

  • roam_move_block

    Move a block to a new parent or position.

  • roam_remember

    specialized tools for AI memory management within Roam.

  • roam_datomic_query

    Execute raw Datalog queries for advanced filtering.

  • roam_markdown_cheatsheet

    Retrieve the Roam-flavored markdown reference.

  • roam_get_guidelines

    Retrieve this graph's user-defined agent conventions.

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS
Cline logo

Cline

Desktop · Free · MIT

An AI coding assistant integrated into the IDE. Supports MCP servers for enhanced functionality.

WindowsMacOSLinux

Related MCP servers

More servers
MaxKB logo

MaxKB

1Panel-dev/MaxKB

16.2k

MaxKB = Max Knowledge Brain, it is an open-source platform for building enterprise-grade agents. MaxKB integrates Retrieval-Augmented Generation (RAG) pipelines, supports robust workflows, and provides advanced MCP tool-use capabilities.

Knowledge Management
UI-TARS-desktop logo

UI-TARS-desktop

bytedance/UI-TARS-desktop

12.9k

TARS is ByteDance's multimodal AI agent stack, shipping two projects: Agent TARS (a CLI and Web UI agent built on MCP) and UI-TARS-desktop (a desktop GUI agent).

Knowledge Management
Supermemory logo

Supermemory

supermemoryai/supermemory

9.4k

State-of-the-art memory and context engine for AI.

Knowledge Management
Cognee logo

Cognee

topoteretes/cognee

2.1k

Cognee - The Free Open-Source AI Memory Platform for Agents.

Knowledge Management
Notion MCP Server (Official) logo

Notion MCP Server (Official)

makenotion/notion-mcp-server

1.5k

For the best experience, use Remote Notion MCP, our official hosted MCP server. This repository is a separate, self-hosted MCP server implementation that is no longer actively maintained or supported. Please use Remote Notion MCP instead.

Knowledge Management
DevDocs logo

DevDocs

cyberagiinc/devdocs

1.4k

[!WARNING] DevDocs Status: Not publicly maintained. Enhanced internal version at CyberAGI — public release coming soon. If you have any questions please reach out to info@cyberagi.ai.

Knowledge Management