Help

Stacks connector for Claude

Stacks keeps the links, articles, posts, notes and files you save. The connector lets Claude search that library, read the items it needs, and save new links and notes to it, when you ask.

Connector URL
https://app.betterstacks.com/api/mcp
Transport
Remote MCP server over Streamable HTTP
Sign-in
OAuth with your Stacks account. Apps register themselves automatically (dynamic client registration), so there is no API key to copy.
Tools
recall, get and save. There is no delete tool.
Works with
Claude (web, desktop and mobile apps), Claude Code, ChatGPT, and other apps that support remote MCP servers with OAuth
Plans
Connecting is free on every Stacks plan

Before you start

You need a Stacks account. If you don’t have one, sign up for free. The connector searches what is already in your library, so save a few things first with the browser extension or at app.betterstacks.com.

Connect Stacks

Claude on the web or desktop

  1. 1In Claude, open Settings → Connectors.
  2. 2Choose Add custom connector. Name it Stacks and paste https://app.betterstacks.com/api/mcp
  3. 3Choose Connect. A Stacks window opens: sign in if asked, check the account shown, and choose Allow.
  4. 4In a chat, make sure Stacks is turned on in the tools menu, then ask about something you saved.

If Stacks is listed in Claude’s connector directory, you can add it from there instead of pasting the URL. Connectors you add on claude.ai are also available in the Claude desktop and mobile apps.

Claude Code

  1. 1Run this once in your terminal: claude mcp add --transport http stacks https://app.betterstacks.com/api/mcp
  2. 2Start Claude Code and run /mcp. Choose Stacks and sign in in the browser window that opens.

ChatGPT

  1. 1Open ChatGPT on the web (chatgpt.com).
  2. 2Go to Plugins, click +, and choose Add custom MCP server.
  3. 3Name it Stacks and paste https://app.betterstacks.com/api/mcp
  4. 4Choose OAuth and sign in to Stacks.
  5. 5In a chat, turn Stacks on from the + menu.

Custom MCP servers need a paid ChatGPT plan and are not available in every workspace. OpenAI may rename these menus.

Other apps that support remote MCP servers with OAuth sign-in can use the same URL: https://app.betterstacks.com/api/mcp

Tools

Claude chooses the tool from what you ask, so you don’t need to name it. Each tool works only on your own Stacks library.

recall

Search your saves

Searches the items in your Stacks library: saved pages and links, X bookmarks, LinkedIn saved posts, quick notes and uploaded files. Read-only.

Inputs

  • query (required): what you are looking for, in plain words, 1 to 500 characters. It can include anything you remember: the topic, the site, roughly when.
  • limit (optional): how many results to return, 1 to 25. The default is 10.

Returns

  • A numbered list of matching saves. Each has its title, URL, the date you saved it, where it came from, a short snippet (up to 300 characters) and an id.
  • The reply says which kind of search ran: search by meaning, or keyword search.
  • If nothing matches, it says so: No saved items in Stacks matched “…”.

Good to know

  • On paid and lifetime plans, and during a trial, recall searches by meaning, so a loose description can find the right save. If that finds nothing (for example, a save that has not been indexed yet), it falls back to keyword search.
  • On the free plan, recall uses keyword search over titles, descriptions, URLs and your notes.
  • Each recall counts as one ask. See plans and limits.
get

Read one save in full

Fetches a single item by the id that recall returned. Claude uses it when a snippet is not enough to answer. Read-only.

Inputs

  • id (required): the item id from a recall result.

Returns

  • The title, URL, saved date, source and type, your tags and the stacks it is in.
  • Its description and summary, your notes, and the saved page content. Saved content longer than 20,000 characters is cut off at that point and marked as truncated.

Good to know

  • If the id does not exist in your library, the reply is No saved item with id …. Ask Claude to run recall again.
  • get does not count as an ask.
save

Save a link or a note

Adds a link or a quick note to your Stacks library. It never deletes anything or overwrites what you wrote. The only change it makes to an existing item is adding a “why” when you save a link you already have.

Inputs

  • url: the link to save. Without a URL, text is saved as a quick note (up to 50,000 characters, plain text or Markdown).
  • title (optional, up to 500 characters). A link without a title uses its URL; a note uses its first line.
  • why (optional, up to 10,000 characters): why you are keeping it, shown on the item as “Why I saved it”.
  • note (optional, up to 10,000 characters): extra context. For a link it goes into the description.
  • source (optional): the app saving it, such as Claude or Claude Code, so you can see later where a save came from.

Returns

  • A one-line receipt with the title, the URL and the new item’s id.

Good to know

  • If you saved the same URL before, Stacks keeps the existing item and adds the new “why” to it rather than making a duplicate.
  • save does not count as an ask.

Example prompts

Ask the way you would ask a colleague who has seen everything you saved.

Find a half-remembered save

“Find the article I saved about onboarding emails a few weeks ago. I think it was a LinkedIn post.”

Read and summarise a save

“Search my Stacks for the pricing teardown I saved, read it, and pull out the three main arguments.”

Work from several saves

“What have I saved about screen recording tools? Compare them in a table with a link to each.”

Plan from what you kept

“Pull together everything I saved about Tokyo, grouped into food, places to stay and things to do.”

Save from the chat

“Save this link to Stacks: [paste a URL]. Why: to compare with our onboarding flow.”

Keep an answer as a note

“Save the checklist above to Stacks as a note titled “Launch checklist”.”

Plans and limits

  • Free plan: 20 asks a month, shared across Stacks, Claude, ChatGPT and other connected apps. Each recall is one ask. Recall uses keyword search.
  • Paid and lifetime plans: unlimited asks, and recall searches by meaning. A trial includes the same while it lasts.
  • get and save are available on every plan and do not count as asks.
  • At the free limit, recall does not search. Claude passes on a short message with a link to upgrade, and your asks start again the next month.
  • Plan details are on the pricing page.

Troubleshooting

The sign-in window keeps sending me back to the Stacks login
After three tries the window stops and shows We could not sign you in to Stacks. Open app.betterstacks.com in the same browser, sign in there, then start connecting again from Claude. Browser settings that block or clear cookies can cause this; allow cookies for betterstacks.com and app.betterstacks.com and try again.
Claude asks you to reconnect Stacks, or a tool says “Not signed in to Stacks”
The sign-in behind the connector has ended, for example because you signed out of Stacks or your session expired. In Claude, open Settings → Connectors, find Stacks and choose Connect (or remove it and add it again), then sign in.
“This app is not registered with Stacks” or “The redirect address does not match”
The app’s registration with Stacks is no longer valid. Remove the Stacks connector in Claude and add it again with https://app.betterstacks.com/api/mcp.
“This sign-in request expired” or “Your Stacks session changed”
The sign-in page was open for more than about ten minutes, or you signed in as a different Stacks user partway through. Close the window and start connecting again from Claude.
Recall finds nothing, or not what I expected

Check that the item is in your library at app.betterstacks.com, and that you connected the same Stacks account you save with (the sign-in page shows which account you are allowing).

On the free plan, recall matches words, so use words that appear in the title, the URL, the description or your notes. On paid plans recall searches by meaning, and a save that has not been indexed for that yet is still found by keyword search.

Claude says I have used my free asks for the month
The free plan includes 20 asks a month, shared between Stacks itself, Claude, ChatGPT and other connected apps. Each recall is one ask, and Claude may run recall more than once to answer one question. The count starts again at the start of each month (UTC). get and save do not count. A paid plan removes the limit; the message includes a link to upgrade.
Claude does not use Stacks when I ask about my saves
Make sure the connector is turned on for the chat (in Claude, the tools menu in the message box lists connected apps). Mentioning Stacks helps: “search my Stacks for…”.
I don’t see “Add custom connector” in Claude
Which Claude plans and workspaces can add custom connectors is set by Anthropic, and in some organisations an admin has to add it. If your plan or workspace doesn’t offer it, you can use Stacks in Claude Code, or in ChatGPT.
“Could not search Stacks right now” or “Stacks is unavailable”
Stacks could not be reached, or the sign-in behind the connector has ended. Try again shortly. If it keeps happening, reconnect the connector (see the entry on reconnecting above). If that does not help, email help@betterstacks.com.

Disconnect and revoke access

  • Claude: open Settings → Connectors, choose Stacks, then disconnect or remove it. Claude stops being able to use Stacks straight away.
  • Claude Code: run claude mcp remove stacks.
  • ChatGPT: remove Stacks from the same Plugins menu where you added it.
  • From the Stacks side: the connector uses the Stacks sign-in from the moment you chose Allow. To end that sign-in for every connected app, email help@betterstacks.com from your account’s email address and we will sign it out. Deleting your Stacks account also ends every sign-in.
  • Disconnecting does not delete anything from your Stacks library. Items the connector saved stay there until you delete them in Stacks.

Privacy and data

  • What it reads: the items in your own Stacks library, and only when Claude calls recall or get for something you asked.
  • What it writes: new links and notes, only when Claude calls save. It cannot delete anything or overwrite what you wrote; the only change to an existing item is adding a “why” when you save a link that is already in your library.
  • What it does not see: the connector does not read your Claude chats, Claude’s memory, your other connectors or your files in Claude. Stacks only receives what Claude sends in a tool call: the search text, an item id, or the link or note to save.
  • What is recorded: Stacks keeps a record of each search (the search text and which items it returned) and counts asks for the free plan limit. On plans that search by meaning, the search text is sent to an embedding model (OpenAI, through Vercel’s AI Gateway) to turn it into a vector; Stacks does not send your library to Claude other than the results you asked for.
  • Your data: your saves belong to you, and the connector only ever works on the account you signed in with. How Stacks handles your data is set out in the privacy policy and terms of service.

Support

Email help@betterstacks.com. Tell us which app you connected from (Claude, Claude Code, ChatGPT), what you asked, and the exact message you saw.

More about using Stacks with AI apps is on the connector overview.