mcp-pandoc: A Document Conversion MCP Server

Name: mcp-pandoc: A Document Conversion MCP Server
Author: vivekVells

@vivekVells

Repository Homepage

About mcp-pandoc: A Document Conversion MCP Server

MCP server for document format conversion using pandoc.

#pandoc #pandoc-markdown #pandoc-template

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-pandoc": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "mcp-pandoc",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

`contents` (string): Source content to convert (required if input_file not provided)

For advanced formats (pdf, docx, rst, latex, epub), an output_file path is required

Overview

What is mcp-pandoc?

mcp-pandoc is a Model Context Protocol server for document format conversion using pandoc. It provides tools to transform content between different document formats while preserving formatting and structure, and is officially included in the Model Context Protocol servers open-source project.

How to use mcp-pandoc?

Install pandoc and the uv package manager, then configure your MCP client (e.g., Claude Desktop) with the mcpServers entry using uvx mcp-pandoc. The server exposes one tool, convert-contents, which accepts source content or an input file, source/target formats, an optional output file, a reference document for DOCX styling, a defaults file, and Pandoc filters.

Key features of mcp-pandoc

Single tool convert-contents for all conversions
Supports 10 formats: markdown, HTML, TXT, DOCX, PDF, RST, LaTeX, EPUB, IPYNB, ODT
Bidirectional conversion between all supported formats (PDF output only)
Advanced features: defaults files (YAML) and Pandoc filters
DOCX output supports custom styling via reference documents
Basic conversions display in chat; advanced formats require output file path

Use cases of mcp-pandoc

Convert Markdown notes to PDF or DOCX documents
Convert HTML content to EPUB for e‑readers
Transform Jupyter notebooks (IPYNB) to Markdown or HTML
Batch convert multiple files between formats using defaults templates
Produce styled DOCX files with custom reference document templates

FAQ from mcp-pandoc

How do I convert content using the `convert-contents` tool?

Provide either the contents string or an input_file path, plus the desired input_format and output_format. For advanced formats (PDF, DOCX, RST, LaTeX, EPUB) you must also supply an output_file path.

Does mcp-pandoc support PDF conversion?

PDF is supported as an output‑only format. Converting from PDF to other formats is not supported. PDF generation requires TeX Live to be installed.

What are the critical requirements before using mcp-pandoc?

You must install pandoc itself, the uv package manager (which provides the uvx command), and optionally TeX Live for PDF output. Complete file paths with filename and extension are mandatory when saving files.

Can I customize the styling of DOCX output?

Yes, you can provide a reference document (.docx or created via pandoc -o reference.docx --print-default-data-file reference.docx) to override default styles. This works only for DOCX output.

What formats are supported and what are the format categories?

Formats are split into Basic (MD, HTML, TXT, IPYNB, ODT – no extra requirements) and Advanced (DOCX, PDF, RST, LaTeX, EPUB – require an output file path). All formats can be bidirectionally converted except PDF (output only).

Comments

More Other MCP servers

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K