Skip to main content
Glama
bookmark-organizer

bookmark-organizer

by dpfcarlos

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

Web tool

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 (organize-bookmarks)

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

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

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

  3. Load the clean file: delete the old bookmarks in the browser (select all with Ctrl+A in the bookmarks manager, then Delete) 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-organizer

Only the MCP server:

claude mcp add bookmark-organizer -- npx -y github:dpfcarlos/bookmark-organizer

Claude 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?

list_profiles

Browsers and profiles found, counts, whether the browser is open

no

stats

Totals, duplicates, empty folders, top domains, top folders

no

get_bookmarks / search_bookmarks

List or search with ids and folder paths

no

find_duplicates

Same page saved more than once (ignores http/https, www, #, utm_*)

no

check_links

Finds dead links (404, domain gone); sites that block bots are reported as "uncertain"

no

export_html / preview_html

Standard bookmarks HTML that any browser imports / preview a file

no

backup / list_backups / restore_backup

Backups and undo

restore only

delete_bookmarks, remove_duplicates, remove_empty_folders

Clean up

yes

create_folder, add_bookmark, move_bookmarks, rename, sort_folder

Reorganize

yes

delete_all_bookmarks

Empty everything

yes

import_html

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 the BOOKMARK_ORGANIZER_BACKUPS environment variable). restore_backup undoes 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 test

The 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 tools
add_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.

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

    A3.7/5.0

    Scored across 21 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to organize and manage Chrome/Edge bookmarks through natural language, with user-controlled permissions, privacy filters, and safety mechanisms.
      Apache 2.0
    • F
      license
      A
      quality
      C
      maintenance
      Enables 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
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude to search, reorganize, and clean up Chrome bookmarks with an interactive review UI and real undo support across Chromium-based browsers.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      11
      18 npm
      1
      MIT