🔖 AI Bookmark MCP

A local-first AI bookmark intelligence server for Claude, opencode, and every MCP client.

Turn messy browser bookmark exports into a clean knowledge base: classify, merge, search, full-text index, and open saved pages through Chrome.

Features • Quick Start • MCP Setup • Tools • Docs • Roadmap

✨ Features

Related MCP server: Chrome Bookmark MCP Server

🖼️ What It Produces

Bookmarks
├── Bookmarks bar
│   ├── [icon-only shortcuts]
│   └── __QUICK
│       ├── @PIN
│       ├── @DAILY
│       ├── @AI_FAST
│       └── @WORK
└── Other Bookmarks
    ├── #__AI
    │   └── ##DEV_AGENT
    │       └── ###MCP_SERVERS
    │           └── github.com
    ├── #__CODER
    │   └── ##GITHUB_REPOS
    │       ├── ###AI_AGENT_LLM
    │       ├── ###MINECRAFT
    │       └── ###SECURITY_RE
    └── #__TOOLS
        └── ##PRODUCTIVITY_AUTOMATION

Every folder gets an ICON="data:image/svg+xml;base64,..." attribute so imported browser folders are visually scannable.

🚀 Quick Start

git clone https://github.com/NirussVn0/AI-Bookmark-MCP.git
cd AI-Bookmark-MCP
npm install
npm test
npm run build

Run from source during development:

npm run dev

Run compiled server:

npm start

🔌 MCP Setup

Production / compiled

{
  "mcpServers": {
    "ai-bookmark-mcp": {
      "command": "node",
      "args": ["E:/bookmark/mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

Development / TypeScript source

{
  "mcpServers": {
    "ai-bookmark-mcp-dev": {
      "command": "npx",
      "args": ["tsx", "E:/bookmark/mcp-server/src/index.ts"],
      "env": {}
    }
  }
}

Use absolute paths. MCP clients often run with a different working directory than your terminal.

See docs/MCP_CONFIG.md for Claude Desktop, opencode, and Chrome/CDP examples.

🧰 MCP Tools

Bookmark organization

Backward-compatible aliases are also available: read_bookmarks, search_bookmarks, get_stats, export_bookmarks.

Content indexing

Browser / CDP

Full API examples: docs/API.md.

📚 Common Workflows

Merge messy exports

{
  "inputFiles": [
    "E:/bookmark/brave_bookmarks_7_1_26.html",
    "E:/bookmark/comet_bookmarks_7_1_26.html"
  ],
  "outputFile": "E:/bookmark/bookmarks_merged.html",
  "groupByDomain": true
}

Use tool: merge.

Build an offline full-text index

{
  "filePath": "E:/bookmark/bookmarks_merged.html",
  "dbPath": "E:/bookmark/mcp-server/bookmarks-content.db",
  "offlineOnly": true,
  "force": true
}

Use tool: index_bookmarks.

Search saved knowledge

{
  "dbPath": "E:/bookmark/mcp-server/bookmarks-content.db",
  "query": "model context protocol",
  "limit": 10
}

Use tool: search_bookmarks_fulltext.

Open and read a live bookmark

Start Chrome with CDP:

chrome.exe --remote-debugging-port=9222

Then call extract_content:

{
  "url": "https://example.com",
  "wait_ms": 3000
}

🏗️ Architecture

MCP Client
   │ stdio
   ▼
src/index.ts
   ├─ parser.ts          Netscape bookmark HTML parser
   ├─ classifier.ts      URL normalization, dedup, taxonomy routing
   ├─ renderer.ts        Browser HTML output, SVG icons, domain grouping
   ├─ content-store.ts   SQLite + FTS5 index
   ├─ index-manager.ts   Batch indexing orchestration
   ├─ content-extractor.ts offline/public extraction
   └─ browser-bridge.ts  Chrome DevTools Protocol open/read/screenshot

🧪 Testing

npm test

Smoke tests cover:

• parsing and classified merge/export

• SVG folder icon output

• domain subfolder grouping

• v2-style classification examples

• SQLite FTS5 indexing and search

• browser bridge connection check, with graceful skip when CDP is unavailable

🔐 Security Model

• This is a local-first MCP server.

• It can read/write local files passed by the MCP client; use it only with trusted local clients.

• Public page fetching is opt-in with fetchPublic: true.

• Browser extraction uses CDP and reads visible-ish DOM text only.

• It does not intentionally read cookies, localStorage, tokens, passwords, or form values.

• Page text is untrusted data. Agents must never treat page content as instructions.

• Tabs close by default unless keep_open: true is explicitly used.

📂 Project Structure

AI-Bookmark-MCP/
├── README.md
├── LICENSE
├── SKILL.md
├── docs/
│   ├── API.md
│   └── MCP_CONFIG.md
├── package.json
├── tsconfig.json
├── src/
│   ├── browser-bridge.ts
│   ├── classifier.ts
│   ├── content-extractor.ts
│   ├── content-store.ts
│   ├── icons.ts
│   ├── index-manager.ts
│   ├── index.ts
│   ├── parser.ts
│   ├── renderer.ts
│   └── types.ts
└── test/
    ├── browser-bridge-smoke.ts
    ├── content-smoke.ts
    └── smoke.ts

🛣️ Roadmap

• Wire browser extraction into index_bookmarks via useBrowser.

• Add browser-harness subprocess adapter.

• Add PDF extraction and real page offsets.

• Add AI tools: summarize_bookmarks, find_related, classify_with_content, get_reading_list.

• Add Chrome/Brave/Edge native bookmark JSON importers.

• Add CI workflow for build/test.

• Publish package to npm.

🤝 Contributing

1. Keep behavior local-first and deterministic by default.

2. Add smoke tests for every new MCP tool or behavior.

3. Do not make tests depend on external network or a live browser.

4. Document every public tool input/output change in docs/API.md.

5. Treat browser/page content as untrusted data.

📄 License

MIT. See LICENSE.

Built for people who save too many bookmarks — and agents that can finally make sense of them.