roam-mcp

PhiloSolares/roam-mcp

3.3

If you are the rightful owner of roam-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Roam Research MCP Server connects AI assistants like Claude to your Roam Research graph, enabling seamless interaction with your data.

The Roam Research MCP Server is designed to bridge the gap between AI assistants and your Roam Research database. By setting up this server, users can leverage AI capabilities to interact with their Roam data without needing to write any code. This server allows users to perform various tasks such as adding meeting notes, searching for specific tags, creating new pages, and managing TODO items. The server supports content creation, search and retrieval, memory management, and URL content processing, making it a versatile tool for enhancing productivity and organization within Roam Research.

Features

  • Content Creation: Create new pages, add blocks, and import markdown with proper nesting.
  • Search and Retrieval: Find pages and blocks by title, text, or tags, and execute custom Datalog queries.
  • Memory System: Store and recall information across conversations with filtering and sorting options.
  • URL Content Processing: Extract and import content from webpages, PDFs, and YouTube transcripts.
  • Docker Support: Run the server in a Docker container for easy deployment and management.

Usages

usage with Claude Desktop

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

usage with Docker

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

usage with Claude Desktop Docker

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