browser-search-mcp

A Model Context Protocol (MCP) server that lets Claude search through your browser bookmarks and browsing history. Works with Chrome, Firefox, Edge, and Brave on Windows, macOS, and Linux.

What it does

Ever wanted to ask Claude "what was that article I read last week about Rust performance?" or "find my bookmark about Kubernetes networking"? This MCP server makes that possible by giving Claude read-only access to your browser data.

Features

Search bookmarks by keyword across title, URL, and folder
Search history with configurable time range (last N days)
Browse bookmarks organized by folder structure
Multi-browser support: Chrome, Firefox, Edge, Brave
Multi-profile support: finds all browser profiles automatically
Cross-platform: Windows, macOS, Linux
Read-only: never modifies your browser data
Safe: copies SQLite databases to temp files to avoid lock conflicts

Tools Provided

| Tool | Description | |------|-------------| | list_browsers | Discover all browser profiles on the system | | search_bookmarks | Search bookmarks by keyword (title, URL, folder) | | search_history | Search browsing history by keyword with date filtering | | list_bookmarks | Browse bookmarks organized by folder |

Quick Start

Install

pip install browser-search-mcp

Or install from source:

git clone https://github.com/yourname/browser-search-mcp.git
cd browser-search-mcp
pip install -e .

Configure Claude Desktop

Add this to your Claude Desktop configuration file:

Windows (%APPDATA%\Claude\claude_desktop_config.json): macOS (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "browser-search": {
      "command": "python",
      "args": ["-m", "browser_search_mcp.server"]
    }
  }
}

If installed via pip:

{
  "mcpServers": {
    "browser-search": {
      "command": "browser-search-mcp"
    }
  }
}

Restart Claude Desktop

After saving the config, restart Claude Desktop. You should see the browser-search tools available in the tools menu.

Usage Examples

Once configured, you can ask Claude things like:

"Search my bookmarks for anything about Docker"
"What websites did I visit about machine learning in the last 7 days?"
"Show me all my bookmarks in the Dev folder"
"Find that GitHub repo I visited yesterday about React animations"
"List all my browser profiles"

How It Works

Bookmarks: Reads Chrome/Edge/Brave Bookmarks JSON files directly
History: Copies the SQLite History database to a temp file, then queries it (avoids browser lock conflicts)
Firefox: Parses profiles.ini to find all Firefox profiles, reads places.sqlite
Timestamps: Handles the different epoch formats between Chromium (microseconds since 1601) and Firefox (microseconds since 1970)

Privacy & Security

Read-only access: this server never modifies, deletes, or writes to any browser data
Local only: all data stays on your machine, no external API calls
Temp copies: SQLite databases are copied to temp files and deleted after reading
No telemetry: zero data collection

Browser Data Paths

| Browser | Windows | macOS | Linux | |---------|---------|-------|-------| | Chrome | %LOCALAPPDATA%\Google\Chrome\User Data | ~/Library/Application Support/Google/Chrome | ~/.config/google-chrome | | Firefox | %APPDATA%\Mozilla\Firefox\Profiles | ~/Library/Application Support/Firefox/Profiles | ~/.mozilla/firefox/Profiles | | Edge | %LOCALAPPDATA%\Microsoft\Edge\User Data | ~/Library/Application Support/Microsoft Edge | ~/.config/microsoft-edge | | Brave | %LOCALAPPDATA%\BraveSoftware\Brave-Browser\User Data | ~/Library/Application Support/BraveSoftware/Brave-Browser | ~/.config/BraveSoftware/Brave-Browser |

Development

git clone https://github.com/yourname/browser-search-mcp.git
cd browser-search-mcp
pip install -e ".[dev]"

# Run directly
python -m browser_search_mcp.server

License

MIT

MCP Servers