Skip to main content
Glama
deenesjakoruzh

Heptabase MCP

by LarryStanley
GitHub
TypeScript
MIT License
7
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

@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.

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

Quick Start

The easiest way to use this MCP service is with Claude Desktop via npx:

{ "mcpServers": { "heptabase": { "command": "npx", "args": ["@heptabase/mcp"], "env": { "HEPTABASE_BACKUP_PATH": "/path/to/your/heptabase/backups", "HEPTABASE_AUTO_EXTRACT": "true", "HEPTABASE_WATCH_DIRECTORY": "true" } } } }

See CLAUDE_DESKTOP_NPX.md for detailed setup instructions.

Local Development

  1. Install dependencies:
    npm install
  2. Configure using environment variables. Create a .env file:
    HEPTABASE_BACKUP_PATH=/path/to/your/heptabase/backups HEPTABASE_AUTO_EXTRACT=true HEPTABASE_WATCH_DIRECTORY=true
  3. Start the MCP server:
    npm start

Basic Usage

// Configure backup path await mcpClient.callTool({ name: "configureBackupPath", parameters: { path: "/Users/stanley/Documents/Heptabase-auto-backup" } }); // List available backups const { backups } = await mcpClient.callTool({ name: "listBackups" }); // Search for whiteboards const { whiteboards } = await mcpClient.callTool({ name: "searchWhiteboards", parameters: { query: "Project Planning" } });

Available Tools

Backup Management

  • configureBackupPath - Set backup directory
  • listBackups - List available backups
  • loadBackup - Load a specific backup

Search Operations

  • searchWhiteboards - Search whiteboards
  • searchCards - Search cards

Data Retrieval

  • getWhiteboard - Get whiteboard data
  • getCard - Get card data
  • getCardsByArea - Get cards by position

Export Functions

  • exportWhiteboard - Export to various formats
  • summarizeWhiteboard - Generate summaries

Analysis Tools

  • analyzeGraph - Analyze relationships
  • compareBackups - Compare versions

Development

Project Structure

heptabase-mcp/ ├── src/ │ ├── index.ts # MCP server │ ├── config/ # Configuration │ ├── services/ # Core services │ ├── tools/ # MCP tools │ └── types/ # TypeScript types ├── tests/ # Test files ├── package.json └── tsconfig.json

Testing

npm test

Building

npm run build

Documentation

For detailed documentation, see SPECIFICATION.md.

License

MIT

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting PRs.

Support

For issues and feature requests, please use the GitHub issue tracker.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

View all tools

A Model Context Protocol service that enables AI assistants to search, retrieve, analyze, and export data from Heptabase backups.

  1. Features
    1. Quick Start
      1. Using with Claude Desktop (Recommended)
      2. Local Development
      3. Basic Usage
    2. Available Tools
      1. Backup Management
      2. Search Operations
      3. Data Retrieval
      4. Export Functions
      5. Analysis Tools
    3. Development
      1. Project Structure
      2. Testing
      3. Building
    4. Documentation
      1. License
        1. Contributing
          1. Support

            Related Resources

            Related MCP Servers

            • Metabase MCP Server

              sazboxai
              -
              security
              F
              license
              -
              quality
              A Model Control Protocol server that enables AI assistants to interact with Metabase databases, allowing models to explore database schemas, retrieve metadata, visualize relationships, and execute actions.
              Last updated -
              4
              Python

            • Supabase MCP Server

              ninad7007
              -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that enables AI tools to interact with Supabase databases, providing tools for reading, creating, updating, and deleting records in Supabase tables.
              Last updated -
              Python
              MIT License

            • Heptabase MCP

              LarryStanley
              A
              security
              A
              license
              A
              quality
              A Model Context Protocol service that allows AI assistants to search, retrieve, analyze, and export data from Heptabase backups.
              Last updated -
              14
              7
              TypeScript
              MIT License
              • Apple
              • Linux

            • MCP SQL Server

              ryudg
              -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that provides AI assistants with comprehensive access to SQL databases, enabling schema inspection, query execution, and database operations with enterprise-grade security.
              Last updated -
              4
              2
              TypeScript
              MIT License

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/LarryStanley/heptabse-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server