roam-research-mcp · MCP Server

Beschreibung des Anbieters

MCP server and CLI for Roam Research

Werkzeuge

roam_get_guidelines

Retrieve this graph's user-defined agent conventions, read from the `[[roam/agent guidelines]]` page inside the graph (configurable per graph).… Angabe des Anbieters · Beleg 5

roam_add_todo

Add a list of todo items as individual blocks to today's daily page in Roam. Each item becomes its own actionable block with todo status.… Angabe des Anbieters · Beleg 5

roam_fetch_page_by_title

Fetch page by title. Returns content in the specified format.… Angabe des Anbieters · Beleg 5

roam_create_page

Create a new standalone page in Roam with optional content, including structured outlines and tables, using explicit nesting levels and headings (H1-H3).… Angabe des Anbieters · Beleg 5

roam_create_outline

Add a structured outline to an existing page or block (by title text or uid), with customizable nesting levels. To create a new page with an outline, use the `roam_create_page` tool instead.… Angabe des Anbieters · Beleg 5

roam_import_markdown

Import nested markdown content into Roam under a specific block. Can locate the parent block by UID (preferred) or by exact string match within a specific page.… Angabe des Anbieters · Beleg 5

roam_search_for_tag

Search for blocks containing a specific tag. Use `primary_tag` for the tag to find, and optionally `page_title_uid` to limit search to a specific page. Supports pagination via `limit` and `offset`.… Angabe des Anbieters · Beleg 5

roam_search_by_status

Search for blocks with a specific status (TODO/DONE) across all pages or within a specific page.… Angabe des Anbieters · Beleg 5

roam_search_block_refs

Search for block references within a page or across the entire graph. Can search for references to a specific block, a page title, or find all block references.… Angabe des Anbieters · Beleg 5

roam_search_hierarchy

Search for parent or child blocks in the block hierarchy. Can search up or down the hierarchy from a given block.… Angabe des Anbieters · Beleg 5

roam_find_pages_modified_today

Find pages that have been modified today (since midnight), with pagination and sorting options.… Angabe des Anbieters · Beleg 5

roam_search_by_text

Search for blocks containing specific text across all pages or within a specific page.… Angabe des Anbieters · Beleg 5

roam_search_by_date

Search for blocks or pages based on creation or modification dates. Not for daily pages with ordinal date titles.… Angabe des Anbieters · Beleg 5

roam_markdown_cheatsheet

Provides the comprehensive Roam syntax reference.… Angabe des Anbieters · Beleg 5

roam_remember

Add a memory or piece of information to remember, stored on the daily page with ROAM_MEMORIES_TAG tag and optional categories (unless include_memories_tag is false).… Angabe des Anbieters · Beleg 5

roam_recall

Retrieve all stored memories on page titled ROAM_MEMORIES_TAG, or tagged block content with the same name. Returns a combined, deduplicated list of memories.… Angabe des Anbieters · Beleg 5

roam_datomic_query

Execute a custom Datomic query on the Roam graph for advanced data retrieval beyond the available search tools. This provides direct access to Roam's query engine. Note: Roam graph is case-sensitive.… Angabe des Anbieters · Beleg 5

roam_process_batch_actions

**RATE LIMIT EFFICIENT:** This is the most API-efficient tool for multiple block operations. Combine all create/update/delete operations into a single call whenever possible.… Angabe des Anbieters · Beleg 5

roam_fetch_block

Fetch a block by its UID with optional children (down to a specified depth) and/or ancestors (up to page root).… Angabe des Anbieters · Beleg 5

roam_create_table

Create a table in Roam with specified headers and rows. This tool abstracts the complex nested structure that Roam tables require, making it much easier to create properly formatted tables.… Angabe des Anbieters · Beleg 5

roam_move_block

Move a block to a new location (different parent or position). This is a convenience wrapper around `roam_process_batch_actions` for single block moves.… Angabe des Anbieters · Beleg 5

roam_update_page_markdown

Update an existing page with new markdown content using smart diff. Preserves block UIDs where possible and generates minimal changes.… Angabe des Anbieters · Beleg 5

roam_fetch_page_full_view

Fetch a complete page view that mirrors what Roam Research shows in its UI: the page's own content, plus all linked references (backlinks) grouped by source page, each with their ancestor breadcrumb… Angabe des Anbieters · Beleg 5

roam_get_subpages

Fetch all sub-pages (namespace children) of a given page prefix.… Angabe des Anbieters · Beleg 5

roam_rename_page

Rename a page by changing its title. Identifies the page by current title or UID.… Angabe des Anbieters · Beleg 5

Voraussetzungen

• ROAM_SYSTEM_WRITE_KEY · Umgebungsvariable · optional · Beleg 6
• HTTP_AUTH_TOKEN · Umgebungsvariable · optional · Beleg 6
• CUSTOM_INSTRUCTIONS_PATH · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 7
• ROAM_HOME · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 8
• HTTP_STREAM_PORT · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 8
• HTTP_STREAM_HOST · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 8
• ROAM_API_TOKEN · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 6
• ROAM_GRAPH_NAME · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 6
• ROAM_GRAPHS · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 6
• ROAM_DEFAULT_GRAPH · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 6
• ROAM_GUIDELINES_PAGE · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 6

Installation

npm install -g roam-research-mcp

Eckdaten

—: Angabe nicht belegt.

Maintainer

2b3pro

Repository-Lizenz

MIT

Letzter Repository-Commit

2026-09-29

Commit innerhalb 90 Tagen

Dienstanbieter

Offizielle Dienstherkunft nicht belegt

Dienste

—

Bereiche

Analyse, Content, Büro, Kommunikation

Plattformen

—

Version

5.0.0

Release

v5.0.0

Clients

Claude Desktop, Cline

Zugriffe und Risiken

Zugriffe laut Paketangaben

lesen, schreiben, löschen

Authentifizierung

—

Transport

—

Technische Prüfung

Ungeprüft

Fehlende Angaben bedeuten unbekannte Zugriffe: Vergib nur die nötigen Berechtigungen und sichere Schreibaktionen mit einer Freigabe ab.