PlugWiki
markdownify-mcp logo

Markdownify MCP Server Setup for Claude Code, Cursor and Other Apps

CommunityLocal
GetDockermcp/markdownifyzcaceres/markdownify-mcp

Lets Claude and other assistants turn PDFs, Office files, web pages and YouTube videos into plain Markdown.

This community server converts documents and web content into Markdown text your assistant can read. It handles PDF, Word, Excel and PowerPoint files, images, audio, web pages, YouTube transcripts and whole Git repositories. It runs on your computer with no account or API key, and the catalog Docker image can only see files you mount into it. The slim Docker image skips image and audio conversion, which need the full local install.

Good for

  • People who want Claude to read PDFs, Word, Excel or PowerPoint files
  • Researchers who need a YouTube transcript or web page as clean text
  • Developers who want a whole GitHub repo packed into one document for a prompt

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install markdownify MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the markdownify MCP server to Claude Code. Run this command:
    
    claude mcp add markdownify -- docker run -i --rm mcp/markdownify
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Docker.

The catalog image (mcp/markdownify) cannot see your disk, so the file tools only work on folders you mount. To read PDFs and Office files, add -v /full/path/to/Documents:/data:ro -e MD_ALLOWED_PATHS=/data before mcp/markdownify in the command (as separate args in a JSON config), then give the tools container paths such as /data/file.pdf. The README documents this mount and MD_ALLOWED_PATHS for the catalog image. Web page, YouTube, Bing page and repository tools work without a mount. Image and audio conversion are not in this image.

Built from the package data we hold. Not yet tested by us.

Tools

  • Turns a web page into clean Markdown

    Fetches a web page and returns its content as Markdown. Addresses that point to private networks are rejected.

    Try: “Convert https://example.com/pricing to Markdown.”

    Network · webpage-to-markdown

  • Turns a PDF file into Markdown

    Reads a PDF from a path on the machine running the server and returns its text as Markdown.

    Try: “Convert /data/report.pdf to Markdown.”

    Files · pdf-to-markdown

  • Turns a Word file into Markdown

    Reads a .docx file from a path you give and returns its text as Markdown.

    Try: “Convert /data/contract.docx to Markdown.”

    Files · docx-to-markdown

  • Turns an Excel file into Markdown tables

    Reads a .xlsx file from a path you give and returns its sheets as Markdown.

    Try: “Convert /data/budget.xlsx to Markdown tables.”

    Files · xlsx-to-markdown

  • Turns a PowerPoint file into Markdown

    Reads a .pptx file from a path you give and returns the slide text as Markdown.

    Try: “Convert /data/deck.pptx to Markdown.”

    Files · pptx-to-markdown

  • Turns a YouTube video into Markdown with its transcript

    Fetches a YouTube video page and returns it as Markdown, with the transcript when one is available.

    Try: “Get the transcript of this YouTube video as Markdown.”

    Network · youtube-to-markdown

  • Turns a Bing results page into Markdown

    Takes the address of a Bing search results page and returns the results as Markdown. You supply the page address; it does not run a search from keywords.

    Try: “Convert this Bing results page to Markdown: https://www.bing.com/search?q=mcp”

    Network · bing-search-to-markdown

  • Packs a Git repository into one Markdown document

    Clones a repository from a URL or owner/repo shorthand and returns the file tree and source code in one document. An option compresses the code to cut the size.

    Try: “Pack github.com/owner/repo into Markdown with compression on.”

    Runs code · git-repo-to-markdown

  • Describes an image as Markdown

    Reads an image from a path you give and returns its metadata and a description. Needs the full local install, not the slim Docker image.

    Try: “Describe /data/screenshot.png as Markdown.”

    Files · image-to-markdown

  • Transcribes an audio file to Markdown

    Reads an audio file from a path you give and returns a transcription when possible. Needs the full local install, not the slim Docker image.

    Try: “Transcribe /data/meeting.mp3 to Markdown.”

    Files · audio-to-markdown

  • Reads an existing Markdown file

    Returns the contents of a .md or .markdown file at a path you give.

    Try: “Show me /data/notes.md.”

    Files · get-markdown-file

Read from the source code

Permissions

low risk · 3 things to watch · 1 advisory

Low risk

Every tool is read-only, but the tools fetch web pages you name and, outside Docker, can read any file path your account can reach. Run it in Docker with only the folders you need mounted, or set the allowed-paths variable.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • Local installs can read any file you can

    Without MD_ALLOWED_PATHS the file tools accept any absolute path. Set it to the folders you want exposed, or use Docker with a read-only mount. github.com

  • It fetches pages and clones repos you name

    Web tools request the address you give, and the repository tool runs repomix to clone it. Private-network addresses are blocked for web pages. github.com

  • Old versions had a command injection bug

    Versions up to 0.0.1 let a crafted PowerPoint path run system commands. It was fixed in 0.0.2, so use a current release. github.com

Security advisories

Technical details
Turning on read-onlyAll tools are marked read-only in the source, so there is no separate switch. It writes temporary files to the system temp folder while converting.
Talks toWeb pages, YouTube and Bing result pages you name. Git hosts when converting a repository
Sign-in and keysNo account or key. MD_ALLOWED_PATHS, MARKITDOWN_PATH and REPOMIX_PATH are optional settings.

Questions

Is Markdownify official?

No. It is a community project by zcaceres, listed in the Docker MCP catalog as mcp/markdownify.

Does it need an API key?

No. It uses no account or key. The optional MD_ALLOWED_PATHS, MARKITDOWN_PATH and REPOMIX_PATH settings only change which folders and programs it uses.

Why can't it find my files in Docker?

The container cannot see your disk. Mount the folders you want, then give the tools the container paths, such as /data/file.pdf. The README also says to set MD_ALLOWED_PATHS to the mounted folders.

Why do image and audio conversion fail?

The published Docker image installs only the PDF extras. The README says image OCR and audio transcription need the full local install.

Can it run read-only?

All 11 tools are marked read-only, so it does not change your files. It still writes temporary files while converting.

Does it work without Docker?

Yes. The README gives a local setup with Bun and Python, which installs the full set of converters. Its package page also lists an npm package, but the README does not document that route.

Information

updated Nov 2, 2026

Publisher
Community
Package
mcp/markdownify
Registry
Docker
Transport
stdio
Auth
None
License
MIT
Last commit
Oct 26, 2026
Open issues
12
Listed in
Docker MCP Catalog

GitHubDockerDocker MCP CatalogChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 5
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com
  4. github.com · github.com
  5. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.