HTML to Markdown MCP

An MCP (Model Context Protocol) server that converts HTML content to Markdown format using Turndown.js.

- Features
- Installation
- Usage

- With Claude Code
- With Claude Code (Plugin)
- With Claude Desktop
- With Cursor
- With Codex
- Using Local Development Version
- Available Tools
- When does it activate?

- SSRF Protection
- Allowing Local Network Access

claude mcp add --transport stdio html-to-markdown -- npx html-to-markdown-mcp

claude mcp add --transport stdio html-to-markdown -- html-to-markdown-mcp

/plugin marketplace add levz0r/html-to-markdown-mcp /plugin install html-to-markdown@levz0r/html-to-markdown-mcp

{ "extraKnownMarketplaces": { "levz0r/html-to-markdown-mcp": { "source": { "source": "github", "repo": "levz0r/html-to-markdown-mcp" } } }, "enabledPlugins": { "html-to-markdown@levz0r/html-to-markdown-mcp": true } }

{ "mcpServers": { "html-to-markdown": { "command": "npx", "args": ["html-to-markdown-mcp"] } } }

{ "mcpServers": { "html-to-markdown": { "command": "html-to-markdown-mcp" } } }

Add this server to your Cursor MCP settings file:

{ "mcpServers": { "html-to-markdown": { "command": "npx", "args": ["html-to-markdown-mcp"] } } }

{ "mcpServers": { "html-to-markdown": { "command": "html-to-markdown-mcp" } } }

- Open Cursor Settings:⌘ + ,(macOS) orCtrl + ,(Windows/Linux)
- Navigate toFile→Preferences→Cursor Settings
- Select theMCPoption
- Add a new global MCP server with the configuration above

- Global:~/.cursor/mcp.json(available across all projects)
- Local:.cursor/mcp.jsonin your project directory (project-specific)

After adding the configuration, restart Cursor for the changes to take effect.

Add this server to your Codex configuration using the CLI or by editing the config file:

Option 1: Using Codex CLI (Recommended):

codex mcp add html-to-markdown -- npx -y html-to-markdown-mcp

codex mcp add html-to-markdown -- html-to-markdown-mcp

[mcp_servers.html-to-markdown] command = "npx" args = ["-y", "html-to-markdown-mcp"]

[mcp_servers.html-to-markdown] command = "html-to-markdown-mcp"

The configuration file is located at~/.codex/config.tomlon all platforms (macOS, Linux, and Windows).

After updating the configuration, restart Codex or your Codex session for the changes to take effect.

If you're developing or testing locally, you can add the MCP server directly from your local code:

claude mcp add --transport stdio html-to-markdown -- node /absolute/path/to/html-to-markdown-mcp/index.js

{ "mcpServers": { "html-to-markdown": { "command": "node", "args": ["/absolute/path/to/html-to-markdown-mcp/index.js"] } } }

Replace/absolute/path/to/html-to-markdown-mcpwith the actual path to your cloned repository.

Fetch HTML from a URL or convert provided HTML content to Markdown format.This tool is automatically used by Claude whenever HTML needs to be fetched and converted.

- url(string): URL to fetch and convert (eitherurlorhtmlis required)
- html(string): Raw HTML content to convert (eitherurlorhtmlis required)
- includeMetadata(boolean, optional): Include metadata header (default: true)
- maxLength(number, optional): Maximum length of returned content in characters. Content exceeding this will be truncated with a message. Useful for large pages to avoid token limits.
- saveToFile(string, optional): File path to save the full content. When specified, saves the complete markdown and returns only a summary. Recommended for very large pages.

{ "url": "https://example.com" }

{ "html": "<h1>Hello World</h1><p>This is a <strong>test</strong>.</p>" }

Example 3: Fetch large page and save directly to file

{ "url": "https://www.docuseal.com/docs/api", "saveToFile": "./docuseal-api.md" }

Example 4: Limit returned content length

{ "url": "https://example.com", "maxLength": 5000 }

# Example Domain Source: https://example.com Saved: 2025-10-09T12:00:00.000Z --- # Example Domain This domain is for use in illustrative examples...

Save markdown content to a file on disk. Use this to persist converted HTML or any markdown content.

- content(string, required): The markdown content to save
- filePath(string, required): The file path where the markdown should be saved (can be relative or absolute)

{ "content": "# My Document\n\nThis is some markdown content.", "filePath": "./output/document.md" }

Usage:You can chain both tools together - first convert HTML to markdown, then save the result to a file.

The MCP server will automatically be used by Claude when you:

- Ask to fetch information from a webpage
- Request to convert HTML to Markdown
- Need to extract content from a URL
- Ask to summarize or analyze a webpage
- Request to save markdown content to a file

- "What's onhttps://example.com?"
- "Fetch and summarize this article: https://..."
- "Convert this webpage to Markdown"
- "Extract the main content from this URL"
- "Save this webpage as a markdown file"
- "Fetchhttps://example.comand save it to article.md"

# Clone the repository git clone https://github.com/levz0r/html-to-markdown-mcp.git cd html-to-markdown-mcp # Install dependencies npm install # Run the server npm start

# Run all tests npm test # Run tests in watch mode (re-runs on file changes) npm run test:watch

npm run version:patch # 1.0.0 -> 1.0.1 npm run version:minor # 1.0.0 -> 1.1.0 npm run version:major # 1.0.0 -> 2.0.0

npm run release:patch --otp=<code> npm run release:minor --otp=<code> npm run release:major --otp=<code>

By default, the server blocks URL requests to private and internal network addresses to preventServer-Side Request Forgery (SSRF)attacks. This includes:

# Via CLI flag npx html-to-markdown-mcp --allow-local

# Via environment variable ALLOW_LOCAL_NETWORK=true npx html-to-markdown-mcp

{ "mcpServers": { "html-to-markdown": { "command": "npx", "args": ["html-to-markdown-mcp", "--allow-local"] } } }

Warning:Only enable local network access if you trust the AI agent's URL inputs. With this flag enabled, the server can reach internal services, localhost ports, and cloud metadata endpoints.

- Protocol:Model Context Protocol (MCP)
- Conversion Library:Turndown.js
- Transport:stdio
- Node.js:ES modules

This server uses the same conversion approach asmarkdown-printer, a browser extension for saving web pages as Markdown files.

Extracts web content from a URL and converts it to clean Markdown format.