
Markdownify MCP Server Setup for Claude Code, Cursor and Other Apps
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.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install markdownify MCP
Claude Code
- 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
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-markdownTurns 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-markdownTurns 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-markdownTurns 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-markdownTurns 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-markdownTurns 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-markdownTurns 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-markdownPacks 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-markdownDescribes 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-markdownTranscribes 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-markdownReads 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-only | All 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 to | Web pages, YouTube and Bing result pages you name. Git hosts when converting a repository |
| Sign-in and keys | No 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
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 5Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com