About Chromium Sync MCP
Chromium Sync MCP is an MCP server published by jaidhyani in the Browser category: mCP server for accessing browser data (tabs, history, bookmarks) from Brave, Chrome, and Chromium.
Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/jaidhyani/chromium-sync-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (8)
check_sync_statusCheck what data is accessible (for debugging)
Parameters not published.
get_bookmarksGet bookmarks, optionally filtered by folder
Parameters not published.
get_historySearch browsing history with optional filters
Parameters not published.
get_tabs_all_devicesGet open tabs from all synced devices
Parameters not published.
get_tabs_localGet open tabs from the local browser session
Parameters not published.
search_bookmarksSearch bookmarks by title or URL
Parameters not published.
select_browserSelect which browser to use (when multiple installed)
Parameters not published.
set_profile_pathManually set the browser profile path
Parameters not published.
Ask AI
Ask AI about Chromium Sync MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
3 checks have not been run yet.
Releases
README
chromium-sync-mcp
MCP server for accessing browser data (tabs, history, bookmarks) from Chromium-based browsers.
Supports Brave, Chrome, and Chromium.
Installation
# Using uvx (recommended)
uvx chromium-sync-mcp
# Or install with pip
pip install chromium-sync-mcp
System Requirements
Requires the LevelDB library:
# Ubuntu/Debian
sudo apt-get install libleveldb-dev
# macOS
brew install leveldb
# Fedora
sudo dnf install leveldb-devel
Claude Code Configuration
Add to your Claude Code MCP settings:
{
"mcpServers": {
"chromium-sync": {
"command": "uvx",
"args": ["chromium-sync-mcp"]
}
}
}
Tools
| Tool | Description |
|---|---|
get_tabs_all_devices |
Get open tabs from all synced devices |
get_tabs_local |
Get open tabs from the local browser session |
get_history |
Search browsing history with optional filters |
get_bookmarks |
Get bookmarks, optionally filtered by folder |
search_bookmarks |
Search bookmarks by title or URL |
select_browser |
Select which browser to use (when multiple installed) |
set_profile_path |
Manually set the browser profile path |
check_sync_status |
Check what data is accessible (for debugging) |
get_history
Returns a JSON array of history entries. Supports substring search, regex patterns, and date filtering.
Parameters:
| Parameter | Type | Description |
|---|---|---|
query |
string | Substring match against URL and title (case-insensitive). Cannot be used with pattern. |
pattern |
string | Regex match against URL and title. Cannot be used with query. |
limit |
integer | Maximum results to return. Default: 100 |
days_back |
integer | Only return entries from the last N days. |
after |
string | ISO date or datetime. Only entries on or after this time. |
before |
string | ISO date or datetime. Only entries before this time. |
Date formats: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS
Example response:
[
{
"url": "https://github.com/anthropics/claude-code",
"title": "GitHub - anthropics/claude-code",
"visit_time": "2026-01-11T14:30:00",
"visit_count": 5
}
]
Configuration
Auto-detection
The server automatically detects installed Chromium-based browsers. If multiple browsers are found, you'll be prompted to select one.
Environment Variable
Override auto-detection by setting CHROMIUM_PROFILE_PATH:
export CHROMIUM_PROFILE_PATH=~/.config/google-chrome/Default
Saved Preference
When prompted to select a browser, use select_browser with save_default: true to save your preference to ~/.config/chromium-sync/profile.
Supported Browsers
| Browser | Linux | macOS | Windows |
|---|---|---|---|
| Brave | ✓ | ✓ | ✓ |
| Chrome | ✓ | ✓ | ✓ |
| Chromium | ✓ | ✓ | ✓ |
How It Works
This server reads directly from your browser's local profile files:
- History: SQLite database
- Bookmarks: JSON file
- Synced Tabs: LevelDB (contains tabs from all your synced devices)
No authentication or network requests required.
Headless Setup (Sync Passphrase Entry)
If you're running on a headless server and need to enter your Chrome sync passphrase, use the chromium-sync-setup command. It launches a browser in a virtual display and provides a secure web URL for remote access.
This is a one-time setup per machine. Once you've entered your passphrase and sync is established, you won't need to run this again.
# If you installed via uvx (recommended)
uvx --with chromium-sync-mcp[setup] --from chromium-sync-mcp chromium-sync-setup
# If you installed via pip
pip install chromium-sync-mcp[setup]
chromium-sync-setup
What it does:
- Starts a virtual X display (Xvnc or Xvfb)
- Launches your browser to the sync settings page
- Provides a secure HTTPS URL via Cloudflare tunnel
System requirements (one of):
- TigerVNC:
sudo apt install tigervnc-standalone-server - Or Xvfb + x11vnc:
sudo apt install xvfb x11vnc
The script auto-downloads cloudflared and noVNC, so those don't need manual installation.
License
Apache 2.0
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.