Docs
Everything you need to save links, find them by meaning, share buckets with people, and hand your bookmarks to your agents.
Getting started
Create an account in the web app with email and password, or sign in with Google.
Buckets
Every link lives in a bucket. Buckets are private by default; use them the way you would use folders, except you will rarely need to open them, because search works across all of them. Create one from the sidebar with + new bucket.
Saving a link
Paste a URL into the add bar at the top of any bucket. That is the whole job. From there Bucketmark works in the background:
- Fetch: it reads the actual page, not just the title tag.
- Tag + summarize: AI writes tags and a short summary onto the card.
- Embed: the page's meaning is indexed for semantic search.
You can watch each step land on the card's status trail. If a page cannot be fetched (dead link, paywall), the card is marked failed and you can retry.
Semantic search
The search box at the top searches every bucket you belong to, by meaning. Type the way you would describe the link to a friend:
that article about rust memory safetywarm pasta recipe without creamrust bellek güvenliği ile ilgili makale(any language works)
Results come back ranked, each with a match score. The words you type do not need to appear anywhere on the page; Bucketmark matches what the page is about, not what it says.
Browser extension
The extension is one button: click it on any page and that tab is saved to your Inbox, a private bucket it creates for you automatically. No dialog, no picking a folder. Sort it later in the app, or never; search finds it either way.
- Works in Chrome, Edge, Brave and Firefox. Store listing coming soon; until then, grab it from the platforms section on the home page when it goes live.
- Log in with the same email and password as the web app. If you signed up with Google only, set a password first via "Forgot password".
- Permissions are minimal: read the current tab's URL and title only when you click, and store your login. No background scripts, no tracking.
Mobile apps
Bucketmark for iOS and Android saves from the share sheet, searches by meaning on the go, and pings you when someone invites you to a bucket.
Both apps are coming to the stores soon. Meanwhile the web app works well on a phone browser.
Agents (MCP)
Bucketmark ships a remote Model Context Protocol server, built into the app. There is nothing to install: point any MCP client (Claude Code, Claude Desktop, claude.ai, Cursor, VS Code and others) at
https://app.bucketmark.app/mcp
Option A · Sign in with your browser
If your client supports MCP OAuth (most newer ones do), add the URL above as a custom server or connector. A browser window opens; sign in, click Authorize, done. No tokens to copy.
Option B · Personal Access Token
For clients without OAuth, and for scripts: sign in and open /connect, create a token (it is shown once, revocable any time, optional expiry). The page generates ready-to-paste configs with your token filled in. For Claude Code:
claude mcp add --transport http bucketmark https://app.bucketmark.app/mcp \
--header "Authorization: Bearer bm_pat_your_token_here"
For Cursor or any client that reads mcp.json:
{
"mcpServers": {
"bucketmark": {
"url": "https://app.bucketmark.app/mcp",
"headers": { "Authorization": "Bearer bm_pat_your_token_here" }
}
}
}
What your agent can do
| Tool | What it does |
|---|---|
| search_bookmarks | Semantic search across your bookmarks, by meaning. |
| save_bookmark | Save a URL to a bucket; tags and summary fill in async. |
| list_buckets | Your buckets with your role and counts. |
| create_bucket | Create a new private bucket. |
| list_bookmarks | Bookmarks in a bucket, with filters and pagination. |
| recent_bookmarks | Newest saves across all your buckets. |
| get_bookmark | One bookmark with tags, summary and status. |
| update_bookmark | Edit a bookmark's title, description or tags. |
| move_bookmark | Move a bookmark to another bucket. |
| delete_bookmark | Delete a bookmark. |
| whoami | Your profile. |