mammoth-mcp

NPM version NPM downloads

A Model Context Protocol (MCP) server for converting DOCX files to HTML using mammoth.js.

Features

convert_docx_to_html: Convert DOCX files to clean HTML
convert_docx_to_html_with_images: Convert DOCX files to HTML with embedded base64 images

Installation

$ pnpm install

Development

$ npm run dev $ npm run build

Usage

Configure MCP Client

Add the server to your MCP client configuration (e.g., Claude Desktop):

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

Or if installed globally:

{ "mcpServers": { "mammoth": { "command": "mammoth-mcp" } } }

Available Tools

convert_docx_to_html

Convert a DOCX file to HTML.

Parameters:

filePath (string, required): Absolute path to the DOCX file

Example:

{ "filePath": "/path/to/document.docx" }

convert_docx_to_html_with_images

Convert a DOCX file to HTML with images embedded as base64 data URIs.

Parameters:

filePath (string, required): Absolute path to the DOCX file

Example:

{ "filePath": "/path/to/document-with-images.docx" }

How It Works

This MCP server uses mammoth.js to convert DOCX documents to clean, semantic HTML. The conversion preserves:

Headings
Paragraphs
Lists
Tables
Bold/italic/underline formatting
Images (when using the with_images variant)

LICENSE

MIT

One-click Deploy

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Mammoth MCP Server