MCP Directory

How to add mcp-pandoc to Cursor

Document format conversion (Markdown, HTML, LaTeX, DOCX, PDF, and more) via Pandoc over MCP. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the mcp-pandoc config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of mcp-pandoc's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the mcp-pandoc config there under the "mcpServers" key and restart the client.

Is mcp-pandoc safe to use with Cursor?

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