bucketmark docs

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:

  1. Fetch: it reads the actual page, not just the title tag.
  2. Tag + summarize: AI writes tags and a short summary onto the card.
  3. 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.

Buckets & sharing

Inviting people

Open a bucket's settings and invite people by email. Everyone in a shared bucket saves into the same place, and everything anyone saves becomes searchable for everyone in it.

RoleCan do
ownerEverything: manage members and roles, edit the bucket, delete it.
editorSave, edit and remove links.
viewerRead and search.

Public pages

Any bucket you own can be published at a public link, so a reading list becomes a page you can send to anyone. Prefer something quieter? Share it unlisted: only people with the URL can see it, and it stays out of the public index.

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

ToolWhat it does
search_bookmarksSemantic search across your bookmarks, by meaning.
save_bookmarkSave a URL to a bucket; tags and summary fill in async.
list_bucketsYour buckets with your role and counts.
create_bucketCreate a new private bucket.
list_bookmarksBookmarks in a bucket, with filters and pagination.
recent_bookmarksNewest saves across all your buckets.
get_bookmarkOne bookmark with tags, summary and status.
update_bookmarkEdit a bookmark's title, description or tags.
move_bookmarkMove a bookmark to another bucket.
delete_bookmarkDelete a bookmark.
whoamiYour profile.
Every tool runs as you and obeys the same bucket roles as the apps: an agent connected to a viewer account can search a bucket but cannot delete from it. Revoking a token at /connect cuts access immediately.