Overview
Heptabase’s MCP (Model Context Protocol) allows external AI services to interact with your Heptabase space, such as creating note cards or adding content to your journal. This enables seamless integration between Heptabase and AI tools like ChatGPT or Claude.
Currently, two basic tools are supported:
Save as a card
Allows the AI to create a new note card in your Heptabase space.
The created card appears in your Inbox, similar to content added via the Web Clipper.
Append to Journal
Allows the AI to add content as new blocks to today’s journal.
This will not overwrite existing content — it works like adding a voice note.
Connecting an External AI Service to Heptabase MCP
⚠️ Important: Private Beta Access
MCP integration is currently in private beta. Only invited users can connect to our MCP server and use our tools; otherwise, you may encounter errors.
If you’d like to join our private beta, fill out this short form to join the waitlist and receive priority access
General Flow
You can connect Heptabase MCP to any third-party AI service that supports the Model Context Protocol (MCP) — for example, ChatGPT or Claude.
In the external AI service, find where you can add or connect an MCP server.
Enter the Heptabase MCP endpoint URL:
https://api.heptabase.com/mcp
The page will automatically redirect you to Heptabase, where you’ll:
Sign in to your account (if not already logged in)
Authorize the connection
After authorization, you’ll be redirected back to the external AI service — the connection is now established.
You can now use Heptabase’s MCP tools directly within that service.
Example: Connecting MCP with ChatGPT
Note: ChatGPT’s Team Plan currently does not support MCP connections.
You’ll need to use a Personal Plus Plan or a higher plan.
To connect Heptabase MCP to ChatGPT:
Open ChatGPT Settings → Apps & Connectors → Advanced settings.
Enable Developer mode.
In Apps & Connectors, click Create (top right corner).
Fill in the following fields:
Icon: You can download our logo file here
Name: You can choose any name you like
MCP Server URL:
https://api.heptabase.com/mcpAuthentication:
OAuth
You’ll be redirected to the Heptabase login page:
Log in (if needed) and click Allow to grant authorization.
Return to ChatGPT. In the chat box, click the “+” button on the left, and select the MCP integration you just created.
You can now use Heptabase MCP commands directly within ChatGPT conversations! Try saying, "Send this conversation to my journal" or "Create a card in Heptabase for me" and see how it works.
Current known issues:
Last updated: 2025/11/03
You might run into errors when trying to use tools on the ChatGPT mobile app.