Markdownify — Claude Code MCP server: what it does, how to install
Markdownify transforms PDFs, office documents, audio recordings, and web pages into clean Markdown. It lets coding assistants inspect varied media files directly.
no license updated 2026-10-29
Open on GitHubWhat Markdownify does
This MCP server processes raw files and online content, returning plain Markdown text to the assistant. Supported inputs include PDF papers, DOCX files, Excel sheets, presentations, and OCR for images. It can also pull transcripts from YouTube clips and convert search results.
Under the hood, the server relies on a local Python environment running markitdown. It builds with Bun, compiling TypeScript into a Node runtime bundle. To protect your filesystem, define MD_ALLOWED_PATHS. This variable prevents tools from reading directories outside your designated list.
The published Docker container provides only markitdown[pdf]. Sound transcription and image recognition will fail in the container unless you run the full stack locally with Bun.
What it helps with
- turn spreadsheets and slide decks into readable Markdown tables
- transcribe speech from sound files directly into context
- extract clean text and structure from PDF or DOCX files
- pull transcripts from YouTube links for summarization
- restrict agent file access to specific allowed folders
Example prompts for the agent
- Convert the spreadsheet
data.xlsxinto Markdown format. - Extract the full transcript from this YouTube video URL.
- Transcribe the voice memo
audio.m4aand save it as Markdown.
How to install Markdownify
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Markdownify
How do you set up Markdownify for Claude Code?
Clone the repository, run bun install, and compile the project using bun run build. Next, point dist/index.js under the mcpServers entry in your client configuration.
What does the Markdownify server do?
It equips coding assistants with tools to transform documents, audio tracks, search hits, and web pages into standard Markdown.
Why do audio and image tools fail in Docker?
The published container image installs only markitdown[pdf]. To run OCR or speech transcription, build the project locally with bun install.