bookmark-organizer
Provides tools to read and modify Brave browser bookmarks directly, including listing and searching bookmarks, finding duplicates and broken links, reorganizing folders, creating/moving/renaming/deleting bookmarks, importing/exporting HTML, and backing up or restoring changes.
Provides tools to read and modify Opera browser bookmarks directly, including listing and searching bookmarks, finding duplicates and broken links, reorganizing folders, creating/moving/renaming/deleting bookmarks, importing/exporting HTML, and backing up or restoring changes.
Provides tools to read and modify Vivaldi browser bookmarks directly, including listing and searching bookmarks, finding duplicates and broken links, reorganizing folders, creating/moving/renaming/deleting bookmarks, importing/exporting HTML, and backing up or restoring changes.
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., "@bookmark-organizer Organize my Chrome bookmarks into folders by topic."
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.
Bookmark Organizer
English · Português · Español · Français · Deutsch · Italiano · Русский · 简体中文 · 日本語 · 한국어 · हिन्दी · العربية
Clean up and organize your browser bookmarks, by hand or by asking an AI assistant to do it for you.
The project has three parts:
Part | For whom | What it does |
Anyone | A single page that runs in your browser. Load your exported bookmarks, remove duplicates and empty folders, group links by site, sort, move, rename, delete, then download a clean file. Nothing is uploaded. | |
MCP server | People using Claude Desktop, Claude Code, Cursor, VS Code or any MCP client | Lets the AI read and change the bookmarks of Chrome, Edge, Brave, Vivaldi, Opera and Chromium directly on your computer: list, search, find duplicates and broken links, reorganize into folders, export, delete everything and load a new set, restore backups. |
Skill ( | Same as above | Teaches the AI the safe way to do it: export a backup first, make sure the browser is closed, show a preview and only apply after you confirm. |
1. Web tool (no installation)
Open https://dpfcarlos.github.io/bookmark-organizer/ (or download docs/index.html and open it).
Export your bookmarks: in Chrome/Edge/Brave press
Ctrl+Shift+O, open the ⋮ menu and choose Export bookmarks. In Firefox:Ctrl+Shift+O→ Import and Backup → Export Bookmarks to HTML.Organize the file in the page (available in English, Português, Español, Français, Deutsch, Italiano, Русский, 简体中文, 日本語, 한국어, हिन्दी and العربية; the language is picked from your browser and can be changed at the top). Several files can be loaded at once and are merged.
Load the clean file: delete the old bookmarks in the browser (select all with
Ctrl+Ain the bookmarks manager, thenDelete) and use Import bookmarks with the downloaded file.
Keep the original export: it is your backup.
Related MCP server: bookmarks-mcp
2. Let the AI do it (MCP server + skill)
Requirements: Node.js 18 or newer. The server runs on your computer, because that is where your bookmarks are, so it works with desktop apps (Claude Desktop, Claude Code, Cursor, VS Code…), not with a chat that runs only in the cloud.
Claude Code (plugin: MCP server + skill in one step)
/plugin marketplace add dpfcarlos/bookmark-organizer
/plugin install bookmark-organizer@bookmark-organizerOnly the MCP server:
claude mcp add bookmark-organizer -- npx -y github:dpfcarlos/bookmark-organizerClaude Desktop
Open Settings → Developer → Edit Config and add to claude_desktop_config.json:
{
"mcpServers": {
"bookmark-organizer": {
"command": "npx",
"args": ["-y", "github:dpfcarlos/bookmark-organizer"]
}
}
}Restart Claude Desktop. To add the skill, download skills/organize-bookmarks as a .zip and upload it in Settings → Capabilities → Skills.
Cursor, VS Code, Windsurf and other MCP clients
Use the same command in the client's MCP settings: npx -y github:dpfcarlos/bookmark-organizer (stdio).
What to ask
"Organize my Chrome bookmarks into folders by topic."
"Remove duplicate bookmarks and empty folders in Edge."
"Find bookmarks whose links are broken."
"Export my bookmarks, delete them all and load this cleaned file: C:\Users\me\Downloads\bookmarks-organized.html"
"Undo the last change."
MCP tools
Tool | What it does | Changes the browser? |
| Browsers and profiles found, counts, whether the browser is open | no |
| Totals, duplicates, empty folders, top domains, top folders | no |
| List or search with ids and folder paths | no |
| Same page saved more than once (ignores http/https, www, | no |
| Finds dead links (404, domain gone); sites that block bots are reported as "uncertain" | no |
| Standard bookmarks HTML that any browser imports / preview a file | no |
| Backups and undo | restore only |
| Clean up | yes |
| Reorganize | yes |
| Empty everything | yes |
| Load a file, appending into a folder or replacing everything | yes |
Safety
Dry run by default. Every tool that changes something only shows what would happen until it is called with
dry_run: false.Automatic backup before every change, in
~/.bookmark-organizer/backups(change with theBOOKMARK_ORGANIZER_BACKUPSenvironment variable).restore_backupundoes any change.Refuses to write while the browser is open, because the browser would overwrite the file when closing.
Sync: if bookmark sync is on, the sync server can bring deleted items back after a direct edit. For a big cleanup with sync on, prefer the flow export → organize → delete all in the browser → import the clean file, which the skill explains.
Firefox and Safari are not edited directly; use their HTML export with the web tool or
import_html.
Settings via environment variables: BOOKMARKS_FILE (path to a specific Bookmarks file) and BOOKMARK_ORGANIZER_BACKUPS (backup folder).
Development
npm install
npm testThe tests create a fake Chrome profile and drive the MCP server end to end, the same way an AI client does.
License
MIT. Contributions are welcome.
Available Tools
21 toolsadd_bookmarkAdd a bookmarkB
Adds a bookmark to a folder (by id or path, created if missing).
Inputs: url (required), name, force, dry_run, +3 more.
backupBack up bookmarksA
Makes a copy of the profile bookmarks file now. (Every write tool also does this automatically.)
Inputs: profile.
check_linksCheck for broken linksA
Visits bookmarks over the network and reports the ones that look dead (404/410, DNS failure, connection refused). Sites that block bots (401/403/429) are reported separately as "uncertain", never as dead.
Inputs: ids, max, profile, folder_id, +2 more.
create_folderCreate foldersA
Creates a folder path such as "Bookmarks bar/Work/Clients" (missing levels are created). Paths may start with "Bookmarks bar", "Other bookmarks" or "Mobile bookmarks"; otherwise the bookmarks bar is used.
Inputs: path (required), force, dry_run, profile.
delete_all_bookmarksDelete ALL bookmarksA
Empties the bookmarks bar, Other bookmarks and Mobile bookmarks of a profile. A backup is made first. Only use after the user explicitly asked to wipe everything and an export exists.
Inputs: force, dry_run, profile.
delete_bookmarksDelete bookmarks or foldersA
Deletes bookmarks and/or folders by id. Deleting a folder deletes everything inside it. Dry run by default.
Inputs: ids (required), force, dry_run, profile.
export_htmlExport bookmarks to HTMLA
Saves the bookmarks (all, or one folder) as a standard bookmarks .html file that any browser can import (Chrome, Edge, Firefox, Safari, Opera…). Does not change the browser.
Inputs: profile, folder_id, output_path.
find_duplicatesFind duplicate bookmarksB
Groups bookmarks that point to the same page (ignores http/https, www, trailing slash, #fragment and utm_* tracking parameters).
Inputs: profile.
get_bookmarksGet bookmarksA
Lists bookmarks and folders of a profile with their ids and folder path. Use folder_id to look inside one folder, and folders_only for a quick overview of the structure.
Inputs: limit, offset, profile, folder_id, +1 more.
import_htmlImport bookmarks from HTMLA
Loads a bookmarks .html file (exported from any browser or from the web tool) into a profile. mode "append": everything goes inside a new folder (default "Imported") in Other bookmarks. mode "replace": the current bookmarks are removed and the file becomes the new bookmarks (its toolbar folder goes to the bookmarks bar). Dry run by default.
Inputs: input_path (required), mode, force, dry_run, +3 more.
list_backupsList backupsA
Lists the automatic backups made before every change.
Inputs: no named parameters.
list_profilesList browser profilesA
Finds every Chromium-based browser profile (Chrome, Edge, Brave, Vivaldi, Opera, Chromium) on this computer that has bookmarks, with counts and whether the browser is open.
Inputs: no named parameters.
move_bookmarksMove bookmarks or foldersA
Moves items into a folder. Give target_folder_id, or target_path (e.g. "Bookmarks bar/Study/Python") which is created when missing. For a big reorganization, call this once per destination folder with all the ids that go there.
Inputs: ids (required), force, dry_run, profile, +2 more.
preview_htmlPreview an HTML bookmarks fileB
Reads a bookmarks .html file and shows its folder structure and counts without importing anything.
Inputs: input_path (required), max_lines.
remove_duplicatesRemove duplicate bookmarksA
Keeps one copy of each page and deletes the others. Dry run by default.
Inputs: keep, force, dry_run, profile.
remove_empty_foldersRemove empty foldersA
Deletes folders that contain no bookmarks (also folders that only contain empty folders). Dry run by default.
Inputs: force, dry_run, profile.
renameRename a bookmark or folderC
Changes the name (and optionally the URL) of a bookmark, or the name of a folder.
Inputs: id (required), name (required), url, force, +2 more.
restore_backupRestore a backupA
Puts a backup (from list_backups) back in place of the current bookmarks. The current state is backed up first, so this can be undone too.
Inputs: backup_file (required), force, profile.
search_bookmarksSearch bookmarksB
Searches bookmark names, URLs and folder names (case-insensitive).
Inputs: query (required), limit, profile.
sort_folderSort a folderA
Sorts the contents of a folder alphabetically, folders first. Use recursive to sort every subfolder too. Without folder_id, sorts everything except the bookmarks bar top level (whose order users usually choose by hand).
Inputs: by, force, dry_run, profile, +2 more.
statsBookmark statisticsA
Overview of a profile: totals, top domains, empty folders, very old bookmarks. Good first step before proposing a cleanup.
Inputs: top, profile.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Each tool targets a clearly distinct operation: discovery, reading, searching, duplicate detection vs removal, link checking, backups, deletion, folder/bookmark creation, moving, renaming, sorting, and import/export. The closest pairs (find_duplicates vs remove_duplicates, delete_bookmarks vs delete_all_bookmarks, preview_html vs import_html) are explicitly differentiated by dry-run/scope/read-only wording.
Most names follow a consistent snake_case verb_noun pattern (list_profiles, create_folder, move_bookmarks, export_html). A few tools use a bare verb or noun (stats, backup, rename) rather than a full verb_noun form, which is a minor deviation but still readable and predictable.
21 tools is on the higher side, but each covers a distinct bookmark-management concern: profile discovery, reading, search, analysis, backups, deletions, organization, and import/export. There is little redundancy, though the surface is slightly heavy for the domain.
The tool set covers the full lifecycle: profile discovery, bookmark reading/searching, stats, duplicate detection and cleanup, link checking, backup/restore, granular and bulk deletion, folder creation, bookmark addition, moving, renaming, sorting, empty-folder cleanup, and HTML import/export. Cross-profile copy is achievable via export/import, so there are no significant gaps.
Maintenance
Related MCP Connectors
All your bookmarks in one library. Share them with your AI agents. Read-only search over your saves.
Save, search, read, tag, and organize your bookmarks from AI assistants with OAuth sign-in.
Search and chat with your X bookmarks, with citations back to the original posts.
Search, save, tag, and summarize the links in your Link Crypt bookmark library.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to organize and manage Chrome/Edge bookmarks through natural language, with user-controlled permissions, privacy filters, and safety mechanisms.Apache 2.0
- FlicenseAqualityCmaintenanceEnables AI assistants to search, browse, add, and delete Chrome and Edge bookmarks through the MCP protocol, using a local FastMCP server that directly reads and modifies browser bookmark files.5-
- AlicenseNot gradedqualityCmaintenanceEnables Claude to search, reorganize, and clean up Chrome bookmarks with an interactive review UI and real undo support across Chromium-based browsers.MIT
- AlicenseAqualityBmaintenanceEnables reading and writing Chrome bookmarks (folders, URLs, search, move, remove) through MCP clients like Claude Code, using a companion Chrome extension for secure local communication.1118 npm1MIT