Use monomarks with Claude

Save and search your bookmarks from any Claude conversation. Monomarks runs an MCP server, which means Claude can call into it directly — no copy-pasting URLs back and forth.

What you can do

Once it's set up, you can say things to Claude like:

• “Save this article to my monomarks with the tag 'design'.”
• “What did I bookmark about ATProto last month?”
• “Show me everything I've saved tagged 'rust'.”

Claude can also help you tidy up — ask it to find duplicates, summarise a tag, or delete things you don't want.

The eight things Claude can do on your behalf: save bookmarks, fetch one by URI, list your most recent, search across your saved items, list by tag, list all your tags with counts, edit a bookmark's note/tags/title, and delete one.

Set it up

You'll need a token first. The token is what proves Claude is you.

1. Go to Settings → API Tokens.
2. Click Generate token, give it a name (e.g. “Claude.ai” or “my laptop”), and copy the token. You'll only see it once.

Then pick your Claude:

claude.ai (browser)

1. In claude.ai, open Settings → Connectors.
2. Click Add custom connector.
3. Fill in:
   • Name: Monomarks
   • URL: https://monomarks.at/mcp
   • Authentication: Bearer token — paste your mm_pat_… value
4. Save.

You should see Monomarks in your connectors list. Start a new chat and try one of the example phrases above.

Claude Desktop

1. Open ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or the equivalent on Windows/Linux.
2. Add this entry under mcpServers (creating the key if it doesn't exist):

"monomarks": {
  "type": "http",
  "url": "https://monomarks.at/mcp",
  "headers": { "Authorization": "Bearer mm_pat_PASTE_YOUR_TOKEN_HERE" }
}

3. Restart Claude Desktop.

Claude Code (terminal)

claude mcp add --transport http --scope user monomarks https://monomarks.at/mcp \
  --header "Authorization: Bearer mm_pat_PASTE_YOUR_TOKEN_HERE"

Things to know

• One token per device or surface. Generate a separate token for claude.ai vs Claude Code — that way if you lose access to one, you can revoke just that token without breaking the others. Tokens never expire but you can revoke them anytime from the same settings page.
• Tokens are scoped to your account. Claude (or anyone with the token) can only see and modify your bookmarks. There's no way for it to read another user's data, even with a valid token.
• Saved bookmarks go to your PDS. Just like saving via the website — your data stays in your ATProto repository, not ours. Monomarks just helps Claude talk to it.

If something doesn't work

• “Failed to connect” or auth error in claude.ai/Desktop → double-check you copied the whole token (no leading or trailing whitespace, and no missing characters — some fonts make l, 1, and I look identical). Generate a fresh one if in doubt.
• Claude says it can't find the tool → confirm the connector/server is named exactly monomarks and is showing as connected in your settings.
• Save says “no PDS session” → this means you haven't logged in to monomarks recently in your browser. Visit monomarks.at, sign in, then try again. (Reads — finding, listing — work without an active web session; only writes need one.)

Still stuck? Hit me up on Bluesky at @monomarks.at.