Skip to main content
Glama
mcp-browserdata

mcp-browserdata

by igortetyuev

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

chrome

Live CDP (Chrome inspect-mode remote debugging) and profile files + Keychain decrypt

yandex

Profile files (Cookies/Login Data/Bookmarks sqlite+JSON) + "Yandex Safe Storage" keychain decrypt

chromium

Same as Chrome when a profile exists

safari

Cookies.binarycookies + Bookmarks.plist (needs Full Disk Access), passwords per-site via security CLI

obscura

Spawns its own obscura --stealth mcp child and talks MCP to it

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 security

passwords write

file — browser must quit

file — browser must quit

—

security per-site

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 sync

MCP 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 of cookies | bookmarks | credentials | storage; returns SyncStats counters only. direction = merge | src_to_dst | dst_to_src; conflict = newest | prefer_src | prefer_dst | skip; dry_run defaults to true.

  • export_state(browser, path, kinds?, origins?, redact?) / import_state(browser, path, kinds?, dry_run?) — JSON file, chmod 600; values masked unless redact=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 security lookups.

  • 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.

  • obscura state 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 check

License

MIT — see LICENSE.

Available Tools

12 tools
add_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

    B3.2/5.0

    Scored across 12 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables access to browser data (tabs, history, bookmarks) from Chromium-based browsers including Chrome, Brave, and Chromium, directly from local profile files without authentication.
      22 PyPI
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Exposes 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
    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      24
      210 npm
      4
      MIT