Documentation

Everything you need to know about Bookar — from installing the extension to connecting your AI tools.

What is Bookar?

Bookar is a bookmark sync and intelligence platform. It captures every bookmark you save in Chrome, Brave, or Edge, stores them in a personal database on Supabase, automatically generates AI-written summaries using NVIDIA NIM language models, and exposes your entire bookmark history via an MCP (Model Context Protocol) server so your AI assistants can search and reference them.

The core idea: you keep bookmarking things the way you already do. Bookar makes those bookmarks actually useful — searchable by AI, accessible everywhere, and organized without any manual effort from you.

Browser Extension

The Bookar browser extension runs as a Manifest V3 service worker in Chromium-based browsers (Chrome, Brave, Edge). It listens to your browser's bookmark events and syncs any changes to your Bookar account in real time.

Installing the extension (Load Unpacked)

1. Download bookar-extension.zip from your Settings or from the link below.
2. Unzip the file to a folder on your computer.
3. Open Chrome/Brave/Edge and go to chrome://extensions.
4. Enable Developer Mode (top-right toggle).
5. Click Load unpacked and select the unzipped folder.
6. The Bookar icon will appear in your toolbar.

Linking your browser

Once the extension is installed, open your Bookar Dashboard → Connections & AI. You'll see a 6-digit linking code. Click the Bookar extension icon, enter the code, give your device a name (e.g. Work Laptop), and click Link Device.

After linking, the extension begins a one-time backfill of all your existing Chrome bookmarks. New bookmarks added after linking sync within seconds in both directions — bookmarks you add in Bookar are created in your browser, and bookmarks you save in your browser appear in Bookar.

Using the Dashboard

The dashboard at /dashboard is the main interface for viewing, searching, organizing, and managing your bookmarks.

Key features:

• Search — filters bookmarks by title, URL, tag, or AI description in real time
• Folders — organize bookmarks into nested folder paths (e.g. Work/Design/Inspiration)
• Select mode — click the checkbox to enter multi-select mode, then Bulk Move, Delete, or Share
• Share selected — copies a formatted list of selected bookmarks to your clipboard
• Quick add — the + Add Bookmark button in the header adds a bookmark directly to Bookar and syncs it to your browser

AI Descriptions

Whenever a new bookmark is added (from your browser or the dashboard), Bookar calls the NVIDIA NIM API with the Llama 3.1 model to generate a 2–3 sentence description of the page. This description appears in the bookmark detail panel and is also what your AI assistants receive when searching through your bookmarks.

Descriptions are generated asynchronously. You'll see a "Generating AI description..." placeholder briefly while it processes. If a description fails to generate (network error, API limit), the field is left blank and you can add your own notes.

Connecting Claude

Bookar exposes a Model Context Protocol (MCP) server at /api/mcp. To connect Claude Desktop or Claude Code:

1. Go to your Bookar → Connections & AI and generate an API Key.
2. Copy the key (starts with bk_live_...).
3. Open your claude_desktop_config.json file and add:

{
  "mcpServers": {
    "bookar": {
      "type": "http",
      "url": "https://bookar-rereal.vercel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BOOKAR_API_KEY"
      }
    }
  }
}

Restart Claude Desktop. You can now ask Claude things like: "What design tools did I bookmark last month?" or "Find my bookmarks about React performance."

Connecting ChatGPT

ChatGPT MCP connectors require a Plus, Pro, or Enterprise subscription.

1. Open ChatGPT → Settings → Developer Mode → Enable.
2. Go to Connectors → Create Connector.
3. Set Server URL to https://bookar-rereal.vercel.app/api/mcp
4. Set Authentication to API Key.
5. Paste your Bookar API Key (bk_live_...).
6. Save and start a new conversation. You can now ask ChatGPT to search your bookmarks.

MCP & Other Tools

Any tool that supports the MCP protocol can connect to Bookar. This includes Cursor, Windsurf, Continue, and custom MCP clients. Use the same URL (https://bookar-rereal.vercel.app/api/mcp) and Bearer token authentication with your Bookar API key.

The MCP server exposes these tools to your AI:

• search_bookmarks — semantic and keyword search across all bookmarks
• get_recent_bookmarks — returns the N most recently added bookmarks
• add_bookmark — adds a new bookmark to your Bookar account

Troubleshooting