Skip to main content
MCP server CX Codex

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 GitHub

What 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.xlsx into Markdown format.
  • Extract the full transcript from this YouTube video URL.
  • Transcribe the voice memo audio.m4a and 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.

Similar MCP servers

All MCP servers for Writing and docs →

Project sponsors

Companies that keep this analytics open