MCP Directory

How to add mcp-pandoc to Windsurf

Document format conversion (Markdown, HTML, LaTeX, DOCX, PDF, and more) via Pandoc over MCP. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 500★ · stdio · no auth

Windsurf config for mcp-pandoc

uvx mcp-pandoc
{
  "mcpServers": {
    "mcp-pandoc": {
      "command": "uvx",
      "args": [
        "mcp-pandoc"
      ]
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the mcp-pandoc config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5mcp-pandoc's tools become available to Cascade.

Before you start

  • Pandoc installed and on PATH (e.g. `brew install pandoc`, or `apt-get install pandoc`)
  • uv / uvx package manager to run the server (e.g. `brew install uv`, or `pip install uv`)
  • For PDF output: a TeX engine such as TeX Live with xelatex (`brew install texlive`, or `apt-get install texlive-xetex`)
  • No credentials or API key needed — auth is none

What mcp-pandoc can do in Windsurf

convert-contents

Convert content or a file between supported formats (Markdown, HTML, TXT, DOCX, PDF, RST, LaTeX, EPUB, IPYNB, ODT) with optional reference doc, YAML defaults file, and Pandoc filters.

Security

It reads and writes files at the paths the model supplies, so it can overwrite local files; scope its use to a working directory you control. PDF conversion shells out to Pandoc and a LaTeX engine, which must be installed and trusted.

mcp-pandoc + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the mcp-pandoc config there under the "mcpServers" key and restart the client.

Is mcp-pandoc safe to use with Windsurf?

It reads and writes files at the paths the model supplies, so it can overwrite local files; scope its use to a working directory you control. PDF conversion shells out to Pandoc and a LaTeX engine, which must be installed and trusted.

Can it convert from a PDF to Markdown or DOCX?

No. PDF is treated as an output-only format. You can generate PDFs but not parse existing PDFs into other formats.

Why does my PDF conversion fail?

PDF output requires a TeX engine. Install TeX Live (e.g. texlive-xetex) so Pandoc has a LaTeX backend to render the PDF.

Why do I get an error about a missing output path?

Advanced formats (PDF, DOCX, RST, LaTeX, EPUB) require an explicit output file path with the right extension. TXT, HTML, and Markdown can be returned inline.

View repo Full mcp-pandoc page