Docs / Connect / Bookmarks

Index browser bookmarks in ModelBrain

A bookmark folder is a decision about what belongs together, so ModelBrain keeps each folder as one memory instead of one line per link. The bookmarks source reads your browser's bookmark store and indexes each bookmark folder as one memory in a partition called Bookmarks. The folder path is the heading, followed by the title and address of each link. It never visits a link. Available from ModelBrain 0.6.6.

Before you start
Add it
  1. Open the ModelBrain menu, choose Vaults, then Add Source, then Browser bookmarks….
  2. Choose the folder that holds your browser's bookmarks file.
  3. ModelBrain indexes it in the background.

From a terminal, connector_sync register <id> <path> --type bookmarks does the same. For example: connector_sync register marks ~/path/to/profile --type bookmarks.

What it reads
What it skips
Limits and safety

A bookmark store over 256 MiB is refused instead of being copied or parsed. A member over 32 MiB is refused too. Both are recorded as failures. A store that cannot be parsed keeps the members already indexed from it.

ModelBrain removes a member from memory only after it has read its container to the end. If a file cannot be parsed, every member already indexed from it stays put until the next good pass.

This source is hidden from relay callers. Anything that reaches ModelBrain through the hosted relay, which is how ChatGPT and Grok connect, cannot see what this source imported unless you add its partition (and the partition of any other source of the same kind) to that connection's allowlist yourself. Bookmarks reveal what you read and shop for, so this is the default.

Check that it works
  1. Ask your assistant to run ModelBrain diagnostics. The source reports its kind, members, members_failed and last_container_bytes.
  2. Ask a local assistant for the links you saved about a topic.
If something does not work

Nothing was found

The folder you picked has none of the three file names above. In Chrome, the file sits inside the profile folder, for example one named Default.

A new bookmark is missing

Browsers write the file when they decide to, not when you click. Close the browser or wait, then the next pass picks it up.

Questions

How do I add browser bookmarks to ModelBrain?

Open the ModelBrain menu, choose Vaults, then Add Source, then Browser bookmarks, and pick the folder that holds your browser's bookmarks file. Available from ModelBrain 0.6.6.

Which browsers are supported?

Chrome and Edge through the Bookmarks file, Firefox through places.sqlite, and Safari through Bookmarks.plist.

Does ModelBrain visit my bookmarked pages?

No. Nothing is fetched from the network. A memory holds only folder names, link titles and addresses.

Does ModelBrain change my browser data?

No. Firefox's database is copied to a temporary folder and read from the copy. The other stores are only read.

Other sources

Each new source kind has its own page.

Claude Code memory → · ChatGPT export → · Mail → · Calendar and contacts →
Connect an assistant

Sources feed the same memory these assistants read.

Claude Desktop → · Claude Code → · Cursor →