Almanack MCP

Query your Almanack memory from any AI

The Almanack MCP server connects your decision log to the assistant you already use. Ask Claude, Cursor, or ChatGPT a question and it answers from your own entries, then shows you the dates and notes the answer came from. It is read-only, scoped to your account, and included free.

Last updated June 15, 2026

What your assistant can do

search

Keyword search across your entries. Returns the matches with their date, summary, and topics.

fetch

Pull the full content of one entry by id: the whole note plus its decisions, follow-ups, references, and open questions.

ask

A written answer synthesized from your own entries, with the entry ids and dates it came from.

list-entries

Your most recent entries, newest first, with date, summary, and topics.

list-todos

Your open or completed follow-ups, sorted by due date.

Connect it in a minute

1

Create a key

Open Almanack on the web, go to Settings, and find Connect your AI. Create a key. It is shown once, so copy it.

2

Add it to your assistant

Paste the command Almanack gives you into Claude, or add the same server URL and bearer header in Cursor or ChatGPT.

3

Ask

Try "search my Almanack for the pricing decision" or "what did I decide about hiring in March?" The answer comes back with sources.

The command Almanack gives you for Claude looks like this:

claude mcp add --transport http almanack https://usealmanack.com/api/mcp --header "Authorization: Bearer alm_yourkey"

Which assistants work

Claude

First-class, in both the Claude desktop app and Claude Code. The Settings screen hands you the exact command to paste.

Cursor

Add the server URL and your bearer header in Cursor's MCP settings, then call it from chat.

ChatGPT

Works in Developer Mode on Pro, Plus, Business, and Enterprise. Add a custom connector with the URL and key.

Any MCP client

It is a standard streamable HTTP MCP server, so anything that speaks the protocol can connect.

Built so personal stays personal

  • Read-only. The server can read and search your memory. It cannot edit, add, or delete anything.
  • Personal stays personal. Notes you mark personal never reach search or ask over MCP. The wall is enforced on the server.
  • Your key is hashed, never stored in plain text, and you can revoke it any time from Settings.
  • Every request is scoped to your account. One key reads one person's memory, nobody else's.

Questions about the MCP server

What is the Almanack MCP server?

It is a connection that lets an AI assistant read and query your own Almanack memory. Once you add it, you can ask Claude, Cursor, or ChatGPT a question and it answers from your decisions, commitments, and notes, citing the entries and dates it used. It is read-only and scoped to your account.

How do I connect Almanack to Claude?

Open Almanack on the web, go to Settings, and use Connect your AI to create a key. Almanack gives you a ready-to-paste command for Claude. Run it in your terminal for Claude Code, or add the same URL and bearer header in the Claude desktop app, and the tools appear.

Does the Almanack MCP server work with ChatGPT?

Yes, through ChatGPT Developer Mode, available on Pro, Plus, Business, and Enterprise plans. Add a custom connector pointing at the Almanack MCP URL with your key as a bearer token. The search and fetch tools let ChatGPT find an entry and then read the whole thing.

Does it work with Cursor?

Yes. Add the Almanack MCP server URL and your bearer header in Cursor's MCP settings. Cursor can then search your entries, fetch a full note, and ask your memory from inside the editor, with answers grounded in your own decision log.

Is the MCP connection read-only?

Yes. Every tool reads or searches your memory. None of them can edit, add, or delete an entry. Capturing new thoughts stays in the Almanack app by voice or text, so connecting an assistant never puts your record at risk of being changed.

What can the AI see, and do my personal notes leak?

The AI sees only what you ask for: matching entries, a full note you fetch, or a sourced answer. Notes you mark personal are walled off and never enter search or ask over MCP. The wall is enforced on the server, not just in the app.

How do I create or revoke an MCP key?

Both happen in Settings under Connect your AI. Create a key and copy it once, since it is not shown again. To cut off access, revoke the key from the same screen and any assistant using it stops working right away. You can keep several keys for different tools.

What does MCP access cost?

Nothing extra. MCP is how Almanack travels to where you already work, not a separate add-on. It is included in your Almanack Premium subscription, $96 a year or $14 a month, on the web and on iPhone.

What is MCP?

MCP, the Model Context Protocol, is an open standard for connecting AI assistants to outside tools and data. Almanack runs an MCP server over HTTP, so any assistant that speaks the protocol can read your memory through it with your permission.

Start your memory, then connect your AI

$96 a year or $14 a month. Capture a few thoughts, then mint a key in Settings.

Get Almanack
Almanack homeFAQPrivacyTerms