Chrome Bookmarks MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BOOKMARK_PLAN_FILE | No | Default plan file for apply_moves | ~/.chrome-bookmarks-mcp/proposed-moves.tsv |
| BOOKMARK_BRIDGE_PORT | No | WebSocket port the server listens on / the extension dials | 8765 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| bookmarks_statusA | Report whether the Chrome extension bridge is connected and on what port. When disconnected, returns step-by-step setup guidance — call this first if any other tool fails to reach the browser. |
| list_bookmarksA | List bookmarks as a flat array of {id, title, url, folder}. Optionally scope to a folder path (e.g. 'Bookmarks bar/Dev') to avoid returning the whole tree; omit to list everything. |
| list_foldersA | List every folder with its id, title, depth, and full path — useful before adding/moving. |
| search_bookmarksA | Search bookmarks by text in title or URL. |
| statsA | Return counts of bookmarks and folders. |
| ensure_folder_pathA | Ensure a nested folder path exists (e.g. 'Bookmarks bar/Work/Reports'), creating missing levels. Returns the leaf folder. Top level must be 'Bookmarks bar', 'Other bookmarks', or 'Mobile bookmarks'. |
| add_bookmarkA | Add a bookmark. Target a folder by folder_path (created if missing, default 'Bookmarks bar') or by parent_id. A folder_path's top level must be 'Bookmarks bar', 'Other bookmarks', or 'Mobile bookmarks'. |
| create_folderA | Create a folder under parent_path (created if missing, default 'Bookmarks bar') or parent_id. A parent_path's top level must be 'Bookmarks bar', 'Other bookmarks', or 'Mobile bookmarks'. |
| update_bookmarkA | Update a node's title and/or a bookmark's URL, by id. |
| move_bookmarkA | Move a node into a folder by to_path (created if missing) or to_parent_id. A to_path's top level must be 'Bookmarks bar', 'Other bookmarks', or 'Mobile bookmarks'. |
| remove_bookmarkA | Remove a bookmark by id, or a folder and its contents (set recursive=true for folders). |
| find_duplicatesB | List groups of bookmarks that share the same URL. |
| remove_duplicatesA | Remove duplicate-URL bookmarks, keeping the first in each group. Use dry_run=true to preview without deleting. |
| export_jsonA | Export the whole bookmark tree as portable JSON. If file_path is given, write it server-side and return the path; otherwise return the JSON. |
| import_jsonA | Import a previously exported bookmark JSON file (see export_json) under a target folder. Recreates the tree; it does NOT deduplicate, so importing into a folder that already has the same bookmarks will create copies. Target via into_path (created if missing, default 'Other bookmarks') or into_parent_id. |
| apply_movesA | Apply a catalogue plan TSV (columns: id, proposed, current, via, title, url). Creates each target folder and moves the bookmark into it. dry_run=true previews counts without changing anything. delete_junk=true also removes rows whose proposed folder is 'DELETE?'. |
| remove_empty_foldersA | Sweep the tree and delete folders that contain no bookmarks (bottom-up), e.g. folders left empty after a re-catalogue. Skips the permanent roots. dry_run=true lists them without deleting. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 17 tools
Each tool targets a distinct operation: adding, creating, moving, removing, updating, searching, listing, finding duplicates, exporting/importing, applying batch moves, and checking status. No overlapping purposes.
Most tools follow a verb_noun pattern (e.g., add_bookmark, remove_empty_folders), but 'bookmarks_status' and 'stats' deviate slightly from the verb-first convention.
17 tools cover all essential bookmark management operations without being excessive. The count is proportional to the domain's complexity.
The set covers full CRUD, search, duplicate handling, import/export, batch moves, folder management, and connection status. No obvious gaps for typical bookmark workflows.