roam-research-mcp

roam-research-mcp

44
knowledge_and_memory

The Roam Research MCP Server is a work-in-progress project designed to provide comprehensive access to Roam Research's API through a Model Context Protocol interface. It facilitates interactions with Roam Research for AI tools by supporting various operations like page creation, text search, and data querying. This project is not officially affiliated with Roam Research.

Roam Research MCP Server

A Model Context Protocol (MCP) server providing access to Roam Research's API. The server allows AI tools to interact with Roam graphs via a standard interface.

Features

  • .env support for environment variables
  • Input validation
  • Case-insensitive page title matching
  • Recursive block reference resolution
  • Markdown parsing/conversion
  • Daily page integration
  • Efficient batch operations
  • Hierarchical outline creation

Setup

  1. Create a Roam Research API token
  2. Configure environment variables (via .env or MCP settings)
  3. Build the server

Usage

  • Fetch, create, and update pages/blocks
  • Import Markdown content
  • Search for text/tags/date-based content
  • Execute Datomic Queries
  • Memory storage with auto-tagging

Development

  • Build with TypeScript
  • Test using MCP Inspector

License

MIT License.