levz0r/html-to-markdown-mcp

An MCP (Model Context Protocol) server that converts HTML content to Markdown format using Turndown.js.
Table of Contents
- 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?
- Local Development
- Testing
- Publishing a New Version
- Security
- SSRF Protection
- Allowing Local Network Access
- Technical Details
- Related Projects
- License
Features
- 🌐 **Fetch and convert web pages** - Automatically fetch HTML from any URL
- 🔄 Convert HTML to clean, formatted Markdown
- 📝 Preserves formatting (headers, links, code blocks, lists, tables)
- 🗑️ Automatically removes unwanted elements (scripts, styles, etc.)
- 📊 Auto-extracts page titles and metadata
- ⚡ Fast conversion using Turndown.js
- 🔒 **SSRF protection** - Blocks requests to private/internal networks by default
Installation
Or use with npx (no installation required):
Usage
With Claude Code
Add the server using the Claude CLI:
Or if installed globally:
With Claude Code (Plugin)
This project can also be installed as a Claude Code plugin, which bundles the MCP server and makes it easy to share with teams.
**Install directly from GitHub:**
**Or enable for your team** by adding to your project's .claude/settings.json:
With Claude Desktop
Add this server to your Claude Desktop configuration file:
**Using npx (recommended):**
**Or if installed globally:**
With Cursor
Add this server to your Cursor MCP settings file:
**Using npx (recommended):**
**Or if installed globally:**
**Configuration methods:**
1. **Via Cursor Settings (Recommended):**
- Open Cursor Settings: ⌘ + , (macOS) or Ctrl + , (Windows/Linux)
- Navigate to **File** → **Preferences** → **Cursor Settings**
- Select the **MCP** option
- Add a new global MCP server with the configuration above
2. **Manual file editing:**
- **Global:** ~/.cursor/mcp.json (available across all projects)
- **Local:** .cursor/mcp.json in your project directory (project-specific)
After adding the configuration, restart Cursor for the changes to take effect.
With Codex
Add this server to your Codex configuration using the CLI or by editing the config file:
**Option 1: Using Codex CLI (Recommended):**
Or if installed globally:
**Option 2: Manual Configuration:**
Edit ~/.codex/config.toml and add:
Or if installed globally:
The configuration file is located at ~/.codex/config.toml on all platforms (macOS, Linux, and Windows).
After updating the configuration, restart Codex or your Codex session for the changes to take effect.
Using Local Development Version
If you're developing or testing locally, you can add the MCP server directly from your local code:
**With Claude Code:**
**With Claude Desktop:**
Replace /absolute/path/to/html-to-markdown-mcp with the actual path to your cloned repository.
Available Tools
html_to_markdown
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.**
**Parameters:**
- url (string): URL to fetch and convert (either url or html is required)
- html (string): Raw HTML content to convert (either url or html is 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.