Mozilla Readability Parser MCP Server

An model context protocol (MCP) server that extracts and transforms webpage content into clean, LLM-optimized Markdown. Returns article title, main content, excerpt, byline and site name. Uses Mozilla’s Readability algorithm to remove ads, navigation, footers and non-essential elements while preserving the core content structure. More about MCP.

Features

• Removes ads, navigation, footers and other non-essential content
• Converts clean HTML into well-formatted Markdown (also uses Turndown)
• Returns article metadata (title, excerpt, byline, site name)
• Handles errors gracefully

Why Not Just Fetch?

Unlike simple fetch requests, this server:

• Extracts only relevant content using Mozilla’s Readability algorithm
• Eliminates noise like ads, popups, and navigation menus
• Reduces token usage by removing unnecessary HTML/CSS
• Provides consistent Markdown formatting for better LLM processing
• Includes useful metadata about the content

Installation

Installing via Smithery

To install Mozilla Readability Parser for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install server-moz-readability --client claude

Manual Installation

npm install server-moz-readability

Tool Reference

parse

Fetches and transforms webpage content into clean Markdown.

Arguments:

{
  "url": {
    "type": "string",
    "description": "The website URL to parse",
    "required": true
  }
}

Returns:

{
  "title": "Article title",
  "content": "Markdown content...",
  "metadata": {
    "excerpt": "Brief summary",
    "byline": "Author information",
    "siteName": "Source website name"
  }
}

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "readability": {
      "command": "npx",
      "args": ["-y", "server-moz-readability"]
    }
  }
}

Dependencies

• @mozilla/readability - Content extraction
• turndown - HTML to Markdown conversion
• jsdom - DOM parsing
• axios - HTTP requests

License

MIT