mcp-browserdata
Reads, writes and syncs Chrome cookies, passwords, bookmarks and local/session storage — live via CDP remote debugging plus profile files with Keychain decryption — and acts as a source/target for cross-browser sync and export/import of browser state.
Reads and writes Safari cookies (Cookies.binarycookies) and bookmarks (Bookmarks.plist) with Full Disk Access, and manages per-site passwords through the security CLI; can be used as a sync/export target alongside Chrome.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-browserdata sync my Chrome cookies and bookmarks to Safari, dry run first"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-browserdata
MCP server (stdio, FastMCP) for reading, writing, copying and two-way syncing cookies, passwords, bookmarks and local/session storage between installed browsers: Google Chrome, Yandex Browser, Chromium, Safari (best-effort) and obscura (a lightweight headless scraping browser).
Secret values move inside the server process: sync_data / export_state
return only counters, and get_* tools mask values unless reveal=True is
passed explicitly.
How it reaches each browser
Browser | Channel |
| Live CDP (Chrome inspect-mode remote debugging) and profile files + Keychain decrypt |
| Profile files ( |
| Same as Chrome when a profile exists |
|
|
| Spawns its own |
Chromium v10 blobs are AES-128-CBC with a key derived (PBKDF2, salt
saltysalt, 1003 iters) from the browser's * Safe Storage login-keychain
item — the macOS prompt appears once per requesting binary.
Related MCP server: Hermes Browser MCP Server
Capability matrix
Kind | Chrome | Yandex | obscura | Safari |
cookies read | CDP live + file | file | MCP | file (FDA) |
cookies write | CDP live | file — browser must quit | MCP | file — Safari must quit + FDA |
bookmarks r/w | file — write needs quit | file — write needs quit | — | plist — needs FDA (+quit for write) |
passwords read | file + decrypt | file + decrypt | — | per-site |
passwords write | file — browser must quit | file — browser must quit | — |
|
local/session storage | CDP per-origin tab; raw leveldb copy when quit | raw copy when quit | storage_state | — |
Install
git clone <this repo> && cd mcp_browserdata
uv syncMCP client config
{
"mcpServers": {
"browserdata": {
"command": "uv",
"args": ["run", "--directory", "/path/to/mcp_browserdata", "mcp-browserdata"],
"transport": "stdio"
}
}
}Tools
list_browsers()— detected browsers, profile paths, running/CDP/FDA state, capability matrix.get_cookies(browser, domain?, reveal?)/set_cookies(browser, cookies)list_bookmarks(browser)/add_bookmark(browser, url, title, folder?)get_credentials(browser, domain?, reveal?)/set_credential(browser, origin, username, password)get_site_storage(browser, origin, include_session?, reveal?)/set_site_storage(...)sync_data(src, dst, kinds?, domain?, direction?, conflict?, dry_run?)— merge or one-way copy ofcookies | bookmarks | credentials | storage; returnsSyncStatscounters only.direction=merge | src_to_dst | dst_to_src;conflict=newest | prefer_src | prefer_dst | skip;dry_rundefaults to true.export_state(browser, path, kinds?, origins?, redact?)/import_state(browser, path, kinds?, dry_run?)— JSON file, chmod 600; values masked unlessredact=False.
Merge keys: cookie (domain, path, name), credential (origin, username),
bookmark normalized URL, storage per-origin key.
Requirements & permissions
macOS; Python ≥ 3.12, uv
Chrome: remote debugging on (
chrome://inspect/#remote-debugging) for live cookie/storage access; every new connection shows an Allow sheet in Chrome.Keychain prompts ("* Safe Storage") on first decrypt per binary.
Safari: grant Full Disk Access to the app hosting this MCP server, or Safari tools degrade to per-site
securitylookups.Most writes need the target browser quit (sqlite locks, files clobbered on exit) — errors say which app to close.
Security notes
This server exists to move your own credentials between your own browsers. Treat its host app as trusted exactly like Keychain Access.
Syncing a live session copies refresh tokens — two browsers sharing one account will invalidate each other on token rotation.
obscurastate is ephemeral (in-memory jar of a spawned child process) and unrelated to any other obscura instance your tools may run.
Development
uv run pytest # unit tests only
uv run pytest -m live # touches real Chrome/Yandex/obscura (prompts!)
uv run ruff checkLicense
MIT — see LICENSE.
Available Tools
12 toolsadd_bookmarkB
Add one bookmark. ONLY on explicit user request.
Inputs: url (required), title (required), browser (required), folder. Returns: object
export_stateA
Export browser state to a JSON file (chmod 600). Returns path+counts.
redact=True (default) masks secret values — set False for a real backup.
origins lists origins whose storage to include.
Inputs: path (required), browser (required), kinds, redact, +1 more. Returns: object
get_cookiesA
Cookies for a browser, optionally filtered by domain suffix.
Without reveal=True the value field is masked.
Inputs: browser (required), domain, reveal. Returns: result
get_credentialsB
Saved passwords. Passwords are masked unless reveal=True. Safari supports per-site lookup only — pass domain there.
Inputs: browser (required), domain, reveal. Returns: result
get_site_storageB
localStorage (+sessionStorage) for one origin, e.g. "https://example.com". Values masked unless reveal=True.
Inputs: origin (required), browser (required), reveal, include_session. Returns: object
import_stateA
Import a file produced by export_state. ONLY on explicit user request (dry_run=False).
Inputs: path (required), browser (required), kinds, dry_run. Returns: object
list_bookmarksD
All bookmarks with folder paths.
Inputs: browser (required). Returns: result
list_browsersA
Detected browsers: profile paths, running state, CDP/file access and per-kind capabilities (read/write flags).
Inputs: no named parameters. Returns: result
set_cookiesA
Write cookies into a browser's jar. ONLY on explicit user request. Each item: {name, value, domain, path?, expires?, secure?, http_only?, same_site?}.
Inputs: browser (required), cookies (required). Returns: object
set_credentialB
Write one login/password. ONLY on explicit user request.
Inputs: origin (required), browser (required), password (required), username (required). Returns: object
set_site_storageC
Write localStorage/sessionStorage entries for an origin. ONLY on explicit user request.
Inputs: origin (required), browser (required), local, session. Returns: object
sync_dataA
Copy/merge data between two browsers. Returns COUNTERS ONLY — secret values stay inside the server.
kinds defaults to all four. domain limits cookies/credentials/bookmarks by substring and is REQUIRED for per-origin storage sync (unless both browsers are quit Chromium — then whole storage dirs are raw-copied). direction=merge syncs both ways. dry_run=True (default) reports what would change without writing. Run writes only on explicit user request.
Inputs: dst (required), src (required), kinds, domain, +3 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool targets a distinct resource and action: browsers, cookies, bookmarks, credentials, site storage, sync, and export/import are all separate nouns paired with clear verbs. The read/write pairs (get_cookies/set_cookies, get_site_storage/set_site_storage) are trivially distinguishable, and sync_data's counters-only contract further separates it from the explicit per-kind getters.
All names follow a consistent snake_case verb_noun pattern with a small, well-defined verb vocabulary (list/get/set/add/sync/export/import). Minor deviation: reads alternate between `list_` (list_browsers, list_bookmarks) and `get_` (get_cookies, get_credentials, get_site_storage), and writes alternate between `set_` and `add_`, though the distinctions are semantically defensible.
At 12 tools the surface is well within the ideal 3-15 range and every tool maps to a genuine capability of the browser-data domain. No redundant or filler operations are present.
The surface covers discovery, read, write, migration, and backup/restore, but deletion is entirely absent: no remove_bookmark, delete_cookie, delete_credential, or remove_site_storage, so agents cannot undo writes. History and download data are also unaddressed, leaving notable gaps in the browse-and-manage lifecycle.
Maintenance
Related MCP Connectors
Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.
Stealth web browser for agents: search, fetch, click, download and type in persistent MCP sessions.
Browz hosted MCP (free public beta): let an AI app drive your own Browz browser profiles from anywhere. Connect https://mcp.gobrowz.com/mcp and sign in with your Browz account (OAuth) or an agent token. Each call is relayed to the Browz app on your computer, which must be online with Remote control on and have a hardware security chip (Mac Secure Enclave or TPM 2.0). 17 tools: profiles, tabs, navigate, snapshot, act, wait, screenshot. Cookies, downloads and stored sign-ins stay on your computer.
Unofficial Browserless MCP — wraps the Browserless headless-Chromium REST API (browserless.io)
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables access to browser data (tabs, history, bookmarks) from Chromium-based browsers including Chrome, Brave, and Chromium, directly from local profile files without authentication.22 PyPIApache 2.0
- FlicenseNot gradedqualityDmaintenanceEnables browser automation with AI agent support and secure credential management through 20 MCP tools, accessible via stdio or HTTP bridge.-
- AlicenseNot gradedqualityAmaintenanceExposes browser-drive tools over a local MCP endpoint, letting agents control isolated Chromium or Firefox profiles with their own cookies, fingerprints, and proxies to complete authenticated workflows across sessions. Supports profile lifecycle, navigation, clicking, typing, extraction, screenshots, JS evaluation, tabs, cookies, waits, and raw CDP calls.MIT
- AlicenseBqualityBmaintenanceEnables MCP clients to drive the Chrome or Edge tabs you already have open and signed in, by pairing with a local browser extension instead of launching a remote debugging port or a separate automation browser. Exposes 20 tools for accessibility-tree snapshots, clicking and filling, navigation, uploads, screenshots, JavaScript evaluation, and console and network log reading.24210 npm4MIT