AI Atlas

Note-Taking · Knowledge Management

Heptabase MCP

larrystanley/heptabase-mcp

A Model Context Protocol (MCP) service for interacting with Heptabase backup data. This service allows AI assistants like Claude to search, retrieve, analyze, and export Heptabase whiteboards and cards.

View on GitHub

Install

Client configuration

{
  "mcpServers": {
    "heptabase": {
      "command": "/path/to/node",
      "args": [
        "/path/to/your/heptabase-mcp/dist/index.js"
      ],
      "env": {
        "HEPTABASE_BACKUP_PATH": "<HEPTABASE_BACKUP_PATH>",
        "HEPTABASE_AUTO_EXTRACT": "<HEPTABASE_AUTO_EXTRACT>",
        "HEPTABASE_WATCH_DIRECTORY": "<HEPTABASE_WATCH_DIRECTORY>"
      }
    }
  }
}

Environment variables

HEPTABASE_BACKUP_PATHHEPTABASE_AUTO_EXTRACTHEPTABASE_WATCH_DIRECTORY
Author
@larrystanley
Category
Note-Taking, Knowledge Management
License
MIT
Updated
Oct 6, 2026

Features

  • Search whiteboards and cards

  • Automatic backup file management

  • Export to multiple formats (Markdown, JSON, Mermaid)

  • Analyze card relationships

  • Generate whiteboard summaries

  • Smart caching for performance

Tools (13)

  • configureBackupPath

    Set backup directory

  • loadBackup

    Load a specific backup

  • searchWhiteboards

    Search whiteboards by name or content

  • searchCards

    Search cards across all whiteboards

  • getWhiteboard

    Get complete whiteboard data

  • getCard

    Get card content in multiple formats

  • getCardContent

    Get card content as resource (bypasses size limits)

  • getCardsByArea

    Find cards by position on whiteboard

  • exportWhiteboard

    Export to Markdown, JSON, HTML formats

  • summarizeWhiteboard

    Generate AI-powered summaries

  • analyzeGraph

    Analyze card relationships and connections

  • compareBackups

    Compare different backup versions

  • debugInfo

    Get system status and diagnostics

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

Related MCP servers

More servers
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.

Note-Taking
MCP Obsidian logo

MCP Obsidian

MarkusPfundstein/mcp-obsidian

750

MCP server to interact with Obsidian via the Local REST API community plugin.

Note-Taking
MCP Notion Server logo

MCP Notion Server

suekou/mcp-notion-server

671

This server targets the Notion API 2026-03-11 and uses the current database/data source model. It exposes MCP tools, prompts, resources, structured tool results, and optional MCP Apps for interactive Notion workflows.

Note-Taking
Obsidian MCP logo

Obsidian MCP

StevenStavrakis/obsidian-mcp

261

A local Model Context Protocol server that lets MCP-compatible assistants safely read and modify explicitly configured Obsidian vaults.

Note-Taking
MCP Apple Notes logo

MCP Apple Notes

RafalWilinski/mcp-apple-notes

187

A Model Context Protocol (MCP) server that enables semantic search and RAG (Retrieval Augmented Generation) over your Apple Notes. This allows AI assistants like Claude to search and reference your Apple Notes during conversations.

Note-Taking
notion_mcp logo

notion_mcp

danhilse/notion_mcp

171

A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list through Claude. This is a basic implementation tailored specifically for my minimalist todo list setup in Notion.

Note-Taking