Markdownify MCP Server
An MCP server that turns PDF, DOCX, XLSX, PPTX, images, audio, web pages and YouTube transcripts into Markdown
- 2,996 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Reads local files with no folder limit by default
- Fetches pages and data from external services
Install
- Works in
Manual install
git clone https://github.com/zcaceres/markdownify-mcp.git
cd markdownify-mcp
bun install
bun run buildBuild from source; requires bun and Python.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads local files with no folder limit by default
- Fetches pages and data from external services
This is third-party code. Review the repository files before installing.
What it does
The server gives the agent a set of Markdown conversion tools built on markitdown. It handles PDFs, Word documents, Excel sheets, PowerPoint decks, images with metadata and audio with transcription. From the web it fetches pages, Bing search results and YouTube transcripts. Local file access can be limited to a list of allowed folders.
Who it is for. For people feeding the agent documents in various formats who want them as text.
Good fit when
- You need the agent to read a PDF or a slide deck
- You need a YouTube transcript for notes
- You need a web page as clean Markdown
Not a fit when
- You need exact layout and complex PDF tables without loss
- You cannot build from source and have no Docker
Example request
Convert report.pdf to Markdown and pull out the key findingsMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
MD_ALLOWED_PATHS- Folders the server may read files from
MARKITDOWN_PATH- Path to the markitdown executable
REPOMIX_PATH- Path to the repomix executable
Limitations
There is no ready npm package: the project builds from source with bun and creates a Python environment with markitdown. The Docker image includes PDF support only, so audio and image recognition fail there. The YouTube and Bing tools call external services. File access is unrestricted by default.
How to disable. Remove the markdownify block from the MCP config and the cloned repository folder.
FAQ
Why does audio transcription fail in Docker?
The image installs markitdown with PDF support only; audio and images need the local install.
How do I block access to other folders?
List allowed directories in MD_ALLOWED_PATHS.
Discussion
No questions or reviews yet.
Related
MCP serversMicrosoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models
An MCP server on top of pandoc: the agent converts Markdown, HTML, DOCX, LaTeX, EPUB, ODT and other formats into one another
MCP PDF from ComPDF: the agent converts PDFs and images to Word, Excel, Markdown and JSON and merges, splits, protects and compares files via a cloud API
An MCP server built on Docling: converts PDFs into structured documents, builds new ones and feeds them to RAG
PageIndex MCP: long PDFs for an agent
PageIndex MCP
An MCP server that lets an agent read long PDFs through a document tree: retrieval by reasoning instead of a vector database
An MCP server to create and edit Excel files without Microsoft Office: formulas, formatting, charts, pivot tables
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Markdownify MCP Server (this entry) | no | not required | 2,996 | |
| qiaomu-markdown-proxy | no | 508 | a skill that reads a link and hands the agent the full text as | |
| Markdown Exporter | no | 274 | a skill and CLI that turn Markdown into DOCX |
README in short
The README lists supported formats and tools. Install is from source with bun, which prepares a Python environment, then the server is wired to the client via node and the build path. It documents environment variables for markitdown and repomix paths and access limits, plus Docker usage and its limits. MIT licensed.