Skip to content
Back to search

ai-bookmark-organizer

MarketplaceWorks with Claude CodeGitHub

Free tool to clean up and organize browser bookmarks: web tool + MCP server and skill for AI assistants (Chrome, Edge, Brave, Opera, Vivaldi)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dpfcarlos--ai-bookmark-organizer/badge.svg)](/listings/dpfcarlos--ai-bookmark-organizer)

HTML

<a href="/listings/dpfcarlos--ai-bookmark-organizer"><img src="/api/listings/dpfcarlos--ai-bookmark-organizer/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Open **https://dpfcarlos.github.io/ai-bookmark-organizer/** (or download [`docs/index.html`](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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 11 lines
  1. {
  2. "name": "ai-bookmark-organizer",
  3. "owner": { "name": "dpfcarlos" },
  4. "plugins": [
  5. {
  6. "name": "ai-bookmark-organizer",
  7. "source": "./",
  8. "description": "Organize your browser bookmarks with Claude: MCP server + skill."
  9. }
  10. ]
  11. }
README.md · README · 114 lines
  1. # AI Bookmark Organizer
  2. **English** · [Português](README.pt-BR.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Italiano](README.it.md) · [Русский](README.ru.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [हिन्दी](README.hi.md) · [العربية](README.ar.md)
  3. Clean up and organize your browser bookmarks, by hand or by asking an AI assistant to do it for you.
  4. [![test](https://github.com/dpfcarlos/ai-bookmark-organizer/actions/workflows/test.yml/badge.svg)](https://github.com/dpfcarlos/ai-bookmark-organizer/actions) [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  5. ![AI Bookmark Organizer](docs/screenshot.png)
  6. The project has three parts:
  7. | Part | For whom | What it does |
  8. |---|---|---|
  9. | **[Web tool](https://dpfcarlos.github.io/ai-bookmark-organizer/)** | 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. |
  10. | **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. |
  11. | **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. |
  12. ## 1. Web tool (no installation)
  13. Open **https://dpfcarlos.github.io/ai-bookmark-organizer/** (or download [`docs/index.html`](docs/index.html) and open it).
  14. 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*.
  15. 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.
  16. 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.
  17. Keep the original export: it is your backup.
  18. ## 2. Let the AI do it (MCP server + skill)
  19. Requirements: [Node.js](https://nodejs.org) 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.
  20. ### Claude Code (plugin: MCP server + skill in one step)
  21. ```
  22. /plugin marketplace add dpfcarlos/ai-bookmark-organizer
  23. /plugin install ai-bookmark-organizer@ai-bookmark-organizer
  24. ```
  25. Only the MCP server:
  26. ```bash
  27. claude mcp add ai-bookmark-organizer -- npx -y github:dpfcarlos/ai-bookmark-organizer
  28. ```
  29. ### Claude Desktop
  30. Open *Settings → Developer → Edit Config* and add to `claude_desktop_config.json`:
  31. ```json
  32. {
  33. "mcpServers": {
  34. "ai-bookmark-organizer": {
  35. "command": "npx",
  36. "args": ["-y", "github:dpfcarlos/ai-bookmark-organizer"]
  37. }
  38. }
  39. }
  40. ```
  41. Restart Claude Desktop. To add the skill, download [`skills/organize-bookmarks`](skills/organize-bookmarks) as a .zip and upload it in *Settings → Capabilities → Skills*.
  42. ### Cursor, VS Code, Windsurf, Gemini CLI, Codex CLI and other MCP clients
  43. Use the same command in the client's MCP settings: `npx -y github:dpfcarlos/ai-bookmark-organizer` (stdio). Any app that can run local MCP servers over stdio should work; I have tested the server with the standard MCP client from the official SDK, so please open an issue if a specific app misbehaves.
  44. Chat websites that accept only remote MCP servers cannot run it. For those, use the **web tool**, which works alongside any AI chat: export your bookmarks, ask the AI to propose a folder plan, then apply it in the web tool.
  45. ### What to ask
  46. - "Organize my Chrome bookmarks into folders by topic."
  47. - "Remove duplicate bookmarks and empty folders in Edge."
  48. - "Find bookmarks whose links are broken."
  49. - "Export my bookmarks, delete them all and load this cleaned file: C:\Users\me\Downloads\bookmarks-organized.html"
  50. - "Undo the last change."
  51. ## MCP tools
  52. | Tool | What it does | Changes the browser? |
  53. |---|---|---|
  54. | `list_profiles` | Browsers and profiles found, counts, whether the browser is open | no |
  55. | `stats` | Totals, duplicates, empty folders, top domains, top folders | no |
  56. | `get_bookmarks` / `search_bookmarks` | List or search with ids and folder paths | no |
  57. | `find_duplicates` | Same page saved more than once (ignores http/https, www, `#`, `utm_*`) | no |
  58. | `check_links` | Finds dead links (404, domain gone); sites that block bots are reported as "uncertain" | no |
  59. | `export_html` / `preview_html` | Standard bookmarks HTML that any browser imports / preview a file | no |
  60. | `backup` / `list_backups` / `restore_backup` | Backups and undo | restore only |
  61. | `delete_bookmarks`, `remove_duplicates`, `remove_empty_folders` | Clean up | yes |
  62. | `create_folder`, `add_bookmark`, `move_bookmarks`, `rename`, `sort_folder` | Reorganize | yes |
  63. | `delete_all_bookmarks` | Empty everything | yes |
  64. | `import_html` | Load a file, appending into a folder or replacing everything | yes |
  65. ## Safety
  66. - **Dry run by default.** Every tool that changes something only shows what would happen until it is called with `dry_run: false`.
  67. - **Automatic backup** before every change, in `~/.bookmark-organizer/backups` (change with the `BOOKMARK_ORGANIZER_BACKUPS` environment variable). `restore_backup` undoes any change.
  68. - **Refuses to write while the browser is open**, because the browser would overwrite the file when closing.
  69. - **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.
  70. - Firefox and Safari are not edited directly; use their HTML export with the web tool or `import_html`.
  71. Settings via environment variables: `BOOKMARKS_FILE` (path to a specific `Bookmarks` file) and `BOOKMARK_ORGANIZER_BACKUPS` (backup folder).
  72. ## Development
  73. ```bash
  74. npm install
  75. npm test
  76. ```
  77. The tests create a fake Chrome profile and drive the MCP server end to end, the same way an AI client does.
  78. ## License
  79. MIT. Contributions are welcome.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.