MCP Server

Pro & Lifetime only

The MCP Server integration is available on Pro and Lifetime plans.

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.

There is one address to remember, and it is the only thing you ever need to paste:

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, no tokens to copy, no config files to hand-edit. Access is read-only: nothing connected through MCP can add, edit, or delete anything in your library.

Requirements

A Savebase account on the Pro or Lifetime plan
An MCP-compatible AI client (Claude, ChatGPT, Cursor, VS Code, and most others)

Claude (web, desktop, mobile)

Open Claude connectors

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

Add a custom connector

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

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 connector added on claude.ai is also available in Claude for iOS and Android — there is nothing extra to set up on your phone.

Claude Code

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

Authenticate

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

Verify

Run claude mcp list. Savebase should show as connected.

Cursor

Open your MCP config

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

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"
    }
  }
}

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

Enable Developer mode

Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.

Create the Savebase app

Back in Settings → Apps & Connectors, click Create, name it Savebase, and paste https://mcp.savebase.space/mcp.

Authorize

Choose OAuth, sign in with Savebase, and approve. Then enable Savebase for a chat from the composer.

VS Code

Add the server

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

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"
    }
  }
}

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.

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 tools:

Tool	Description
`search_bookmarks`	Search by keyword across titles, content, authors, URLs, notes, and video transcripts
`list_bookmarks`	List bookmarks with optional source/folder filters and pagination
`get_bookmark`	Get full details of a single bookmark by ID
`list_folders`	List all your bookmark folders
`list_tags`	List all your tags

Example Prompts

Try asking your AI assistant questions like:

"What did I save about kettlebell training?"
"Show me my most recent Reddit bookmarks."
"Find all bookmarks in my 'Design Inspiration' folder."
"What articles have I tagged with 'AI'?"
"Summarise the posts I saved last week."

Troubleshooting

Problem	Solution
The app never asks you to sign in	Check the URL is exactly `https://mcp.savebase.space/mcp` — a typo means the client cannot find the sign-in step.
"Pro plan required" during sign-in	MCP is a Pro feature. Upgrade from the Pricing page, then start the connection again from your AI app.
"This request has expired"	Authorization requests are valid for 10 minutes. Start the connection again from your AI app.
Connection stopped working	Check whether the app still appears under Settings → MCP Server → Connected apps. If it was disconnected, reconnect from the app.
Server shows "errored" in Cursor	Delete the old Savebase entry in Cursor Settings → MCP. Re-add it as Type: HTTP (not SSE), then restart Cursor completely.
Tools not showing	Restart your AI client after adding the configuration. Some clients require a full restart to detect new MCP servers.
Empty results	Make sure you have bookmarks saved in your Savebase library. The MCP server only searches your own data.
Lost a manual token	Tokens 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.

Rule Engine

Overview & Setup