Bookmarks Html To Markdown MCP tool

MCP findutils:bookmarks_html_to_markdown

Convert a browser bookmarks.html export (the Netscape bookmark format Chrome, Firefox, Edge and Safari write) into Markdown for Notion, Obsidian or a README. In the default "headings" style each folder becomes an ATX heading nested by depth (## for a top-level folder, ### below it, up to ######) and each bookmark a "- [title](url)" line under its folder, in the order the export lists them; "list" style writes one flat bullet list with the folder path before each link. The document starts with a # heading named after the export (or the title argument), and front_matter adds a YAML block with that title. A bookmark with no title is named after its host. Entities are decoded, Markdown characters in titles are escaped, favicon data is never written, and no link is fetched. An ordinary web page is refused: it has links but no bookmark folder structure.

Needs an API key. Running a tool needs an API key. Keys are not for sale yet: ask for early access. About API keys

Open the tool Try it

Arguments

application/json

input

string required

The bookmarks.html file contents.
style

string optional

"headings" (default): folders as nested headings with link lists under them. "list": one bullet list, each link prefixed with its folder path. One of headings · list. Default "headings".
include_dates

boolean optional

Add "(added YYYY-MM-DD)" after a link when the export carries its ADD_DATE. Default false. Default false.
front_matter

boolean optional

Start the file with a YAML front matter block holding the title. Default false. Default false.
include_empty_folders

boolean optional

Headings style: also write a heading for a folder that holds no links. Default false. Default false.
title

string optional

Document title. Default: the export's own <H1>, else "Bookmarks".

Example arguments

Verified

{
  "input": "<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<TITLE>Bookmarks</TITLE>\n<H1>Bookmarks</H1>\n<DL><p>\n    <DT><H3 ADD_DATE=\"1600000000\">Work</H3>\n    <DL><p>\n        <DT><A HREF=\"https://example.com/\" ADD_DATE=\"1600000000\">Example</A>\n    </DL><p>\n</DL><p>\n"
}

claude mcp add findutils --transport http https://mcp.findutils.com/ --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

curl -X POST https://mcp.findutils.com/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "bookmarks_html_to_markdown",
      "arguments": {
        "input": "<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<TITLE>Bookmarks</TITLE>\n<H1>Bookmarks</H1>\n<DL><p>\n    <DT><H3 ADD_DATE=\"1600000000\">Work</H3>\n    <DL><p>\n        <DT><A HREF=\"https://example.com/\" ADD_DATE=\"1600000000\">Example</A>\n    </DL><p>\n</DL><p>\n"
      }
    }
  }'

Also a REST endpoint

The same tool answers plain HTTP at POST /api/tools/bookmarks-html-to-markdown/execute.

REST reference

Rate limit: 120 a minute, per IP
Auth: API key
REST id: bookmarks-html-to-markdown
MCP name: bookmarks_html_to_markdown
Category: Text
Machine-readable: openapi.json · markdown.md

Arguments

Example arguments

More Text tools

More to explore