Documentation

MCP Server

Account entitlement required

MCP access is available only when it is already included in the signed-in Savebase account's current entitlement.

Savebase exposes a Model Context Protocol (MCP) server so your AI assistants can search and read your saved bookmarks. Ask Claude, ChatGPT, or Cursor something like "What did I save about kettlebell training?" and it will query your Savebase library directly.

Overview

MCP is an open standard that lets AI applications connect to external data sources. Savebase implements an MCP-compatible HTTP endpoint that gives your AI assistant read-only access to your bookmarks, folders, and tags.

For ChatGPT, install the published Savebase plugin. For Claude, Cursor, VS Code, and other MCP clients, use this server address:

text
https://mcp.savebase.space/mcp

You sign in with your Savebase account the same way you would sign into any other app — no API keys or tokens to copy. Access is read-only: nothing connected through MCP can add, edit, or delete anything in your library.

Requirements

  • A Savebase account whose current entitlement includes MCP access
  • The published Savebase plugin for ChatGPT, or an MCP-compatible client such as Claude, Cursor, or VS Code

Claude (web, desktop, mobile)

1

Open Claude connectors

In claude.ai or the desktop app, go to Settings → Connectors.
2

Add a custom connector

Click Add custom connector, name it Savebase, and paste https://mcp.savebase.space/mcp.
3

Connect and sign in

Click Add → Connect, sign in with your Savebase account, and approve. The Savebase tools are now available in your conversations.

Works on mobile too

A remote connector added on claude.ai can be used in Claude for iOS and Android, although new servers cannot be added directly from Claude Mobile. See Anthropic's current remote MCP support notes.

Claude Code

1

Add the server

Run the following in your terminal. Drop --scope user if you only want it in the current project.
bash
claude mcp add --transport http --scope user savebase https://mcp.savebase.space/mcp
2

Authenticate

Start Claude Code and run /mcp. A browser window opens — sign in and approve.
3

Verify

Run claude mcp list. Savebase should show as connected.

Cursor

1

Open your MCP config

Go to Settings → MCP → Add new server, or edit ~/.cursor/mcp.json directly.
2

Add the Savebase server

Add the entry below. Note there is no headers block — authentication happens in the browser.
json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

Reload and authorize

Reload Cursor. The server appears as needing login — click it, sign in, and approve.

Important for Cursor users

Always select HTTP as the server type — not SSE. If you previously had an SSE entry for Savebase, delete it and re-add it as HTTP, then restart Cursor.

ChatGPT

1

Open the Savebase plugin

Visit the official Savebase plugin listing in ChatGPT.
2

Install and sign in

Select the plus button to install Savebase. When prompted, sign in with your Savebase account and approve read-only access to your library.
3

Use Savebase in a chat

Start a new ChatGPT Work conversation and invoke Savebase with @Savebase, or choose it from the composer when you want ChatGPT to search your library.

No developer setup needed

The public plugin replaces the old Developer mode and custom MCP setup for ChatGPT. The MCP server URL above is still used for other compatible clients.

VS Code

1

Add the server

Open the Command Palette, run MCP: Add Server, choose HTTP, and paste https://mcp.savebase.space/mcp.
2

Or edit the config directly

Add this to .vscode/mcp.json in your workspace:
json
{
  "servers": {
    "savebase": {
      "type": "http",
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

Sign in

Start the server from the MCP view. A browser window opens for sign-in — approve, and the tools appear in Copilot Chat's agent mode.

Managing Connected Apps

Every app you sign into is listed under Settings → MCP Server → Connected apps, with the date you connected it and when it last read your library. Click Disconnect to revoke access immediately.

What an app can see

Connected apps get read-only access to your bookmarks, notes, transcripts, folder names, and tags. They never see your password, and they cannot modify your library.

Savebase sends data only when a request causes the connected assistant to query the MCP server; it does not push your library to connected apps in the background or use it to train a Savebase model. Once data reaches an assistant, that provider's privacy and data-use terms apply. See the Savebase Privacy Policy for the full list of what a connected app can receive.

Advanced: Manual Access Token

Some older MCP clients cannot sign in through the browser and need a token sent as a header instead. For those, open Settings → MCP Server → Advanced, enter a label, and click Generate token. The token starts with sb- and stays valid until you revoke it.

json
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp",
      "headers": {
        "Authorization": "Bearer sb-YOUR_MCP_TOKEN"
      }
    }
  }
}

Token security

Savebase never stores your raw token — only a SHA-256 hash. It is shown once when generated, so copy it immediately. Revoke it any time from Settings → MCP Server.

Available Tools

Once connected, your AI assistant has access to these nine tools. Every one of them only reads — none can change anything in your library.

ToolDescription
search_bookmarksSearch by keyword across titles, content, notes, authors, URLs, and video transcripts. Can be narrowed to specific fields, and filtered by platform, folder, tag, creator, date range, or whether a transcript exists.
list_bookmarksBrowse without a keyword, with optional platform, folder, tag, and date filters
list_recent_bookmarksWhat you saved today, this week, this month, or over the last 7 or 30 days
get_bookmarkFull details of one bookmark, with its tags, folders, and a transcript preview
get_bookmark_transcriptRead a long video transcript in chunks, so it never has to load all at once
find_bookmark_by_urlCheck whether a link is already saved. Ignores tracking parameters like utm_source.
list_foldersList your folders, including nesting
list_tagsList all your tags
get_library_statsTotals, a breakdown by platform, your busiest folders and tags, and recent saving activity

Example Prompts

Try asking your AI assistant questions like:

  • "What did I save about kettlebell training?"
  • "Show me everything I saved from Reddit last month."
  • "Find the saved video where someone explains how to set up a Cloudflare Worker."
  • "Have I already saved this link?" — paste a URL
  • "Find all bookmarks in my 'Design Inspiration' folder."
  • "What articles have I tagged with 'AI'?"
  • "Give me a breakdown of my library — how much, from where, top tags."
  • "Summarise the posts I saved last week."

Searching what was said in a video

If you have transcribed a saved video, its spoken content is searchable too. A question like "how do I do X" can surface a step someone explained out loud in a clip you saved months ago — something you cannot search for anywhere else.

Troubleshooting

ProblemSolution
Savebase is not available in ChatGPTOpen the published Savebase plugin, install it, and start a new ChatGPT Work conversation. You no longer need to create a custom app in Developer mode.
The app never asks you to sign inCheck the URL is exactly https://mcp.savebase.space/mcp — a typo means the client cannot find the sign-in step.
"MCP access unavailable" during sign-inSign in with an account whose current entitlement includes MCP access, or contact Savebase support if you believe the entitlement is incorrect.
"This request has expired"Authorization requests are valid for 10 minutes. Start the connection again from your AI app.
Connection stopped workingCheck whether the app still appears under Settings → MCP Server → Connected apps. If it was disconnected, reconnect from the app.
Server shows "errored" in CursorDelete the old Savebase entry in Cursor Settings → MCP. Re-add it as Type: HTTP (not SSE), then restart Cursor completely.
Tools not showingRestart your AI client after adding the configuration. Some clients require a full restart to detect new MCP servers.
Empty resultsMake sure you have bookmarks saved in your Savebase library. The MCP server only searches your own data.
Lost a manual tokenTokens are only shown once. Revoke the old one in Settings → MCP Server → Advanced and generate a new one.

Quick recovery steps

If things aren't working: (1) Disconnect Savebase in your AI app, (2) remove it from Settings → MCP Server → Connected apps, (3) add the connector again and sign in, (4) restart the AI client completely.