MCP Server
Account entitlement required
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:
https://mcp.savebase.space/mcpYou 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)
Open Claude connectors
Add a custom connector
https://mcp.savebase.space/mcp.Connect and sign in
Works on mobile too
Claude Code
Add the server
--scope user if you only want it in the current project.claude mcp add --transport http --scope user savebase https://mcp.savebase.space/mcpAuthenticate
/mcp. A browser window opens — sign in and approve.Verify
claude mcp list. Savebase should show as connected.Cursor
Open your MCP config
~/.cursor/mcp.json directly.Add the Savebase server
headers block — authentication happens in the browser.{
"mcpServers": {
"savebase": {
"url": "https://mcp.savebase.space/mcp"
}
}
}Reload and authorize
Important for Cursor users
ChatGPT
Open the Savebase plugin
Install and sign in
Use Savebase in a chat
@Savebase, or choose it from the composer when you want ChatGPT to search your library.No developer setup needed
VS Code
Add the server
https://mcp.savebase.space/mcp.Or edit the config directly
.vscode/mcp.json in your workspace:{
"servers": {
"savebase": {
"type": "http",
"url": "https://mcp.savebase.space/mcp"
}
}
}Sign in
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
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.
{
"mcpServers": {
"savebase": {
"url": "https://mcp.savebase.space/mcp",
"headers": {
"Authorization": "Bearer sb-YOUR_MCP_TOKEN"
}
}
}
}Token security
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.
| Tool | Description |
|---|---|
search_bookmarks | Search 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_bookmarks | Browse without a keyword, with optional platform, folder, tag, and date filters |
list_recent_bookmarks | What you saved today, this week, this month, or over the last 7 or 30 days |
get_bookmark | Full details of one bookmark, with its tags, folders, and a transcript preview |
get_bookmark_transcript | Read a long video transcript in chunks, so it never has to load all at once |
find_bookmark_by_url | Check whether a link is already saved. Ignores tracking parameters like utm_source. |
list_folders | List your folders, including nesting |
list_tags | List all your tags |
get_library_stats | Totals, 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
Troubleshooting
| Problem | Solution |
|---|---|
| Savebase is not available in ChatGPT | Open 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 in | Check 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-in | Sign 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 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