Markdownify is a Model Context Protocol (MCP) server that converts various file types and web content to Markdown format. It provides a set of tools to transform PDFs, images, audio files, web pages, and more into easily readable and shareable Markdown text.
- Convert multiple file types to Markdown:
- Images
- Audio (with transcription)
- DOCX
- XLSX
- PPTX
- Convert web content to Markdown:
- YouTube video transcripts
- Bing search results
- General web pages
- Retrieve existing Markdown files
-
Clone the Repository:
git clone https://github.com/pashpashpash/markdownify-mcp.git cd markdownify-mcp
-
Install Dependencies:
pnpm install
Note: This will also install
uv
and related Python dependencies. -
Build the Project:
pnpm run build
Add the following to your claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"markdownify": {
"command": "node",
"args": ["path/to/markdownify-mcp/dist/index.js"],
"env": {
"UV_PATH": "/path/to/uv"
}
}
}
}
Note: Replace "path/to/markdownify-mcp" with the actual path to your cloned repository.
youtube-to-markdown
: Convert YouTube videos to Markdownpdf-to-markdown
: Convert PDF files to Markdownbing-search-to-markdown
: Convert Bing search results to Markdownwebpage-to-markdown
: Convert web pages to Markdownimage-to-markdown
: Convert images to Markdown with metadataaudio-to-markdown
: Convert audio files to Markdown with transcriptiondocx-to-markdown
: Convert DOCX files to Markdownxlsx-to-markdown
: Convert XLSX files to Markdownpptx-to-markdown
: Convert PPTX files to Markdownget-markdown-file
: Retrieve an existing Markdown file
# Start TypeScript compiler in watch mode
pnpm run dev
# Build the project
pnpm run build
- Modify
src/server.ts
to customize server behavior - Add or modify tools in
src/tools.ts
If you run into issues, check Claude Desktop's MCP logs:
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
Note: This is a fork of the original markdownify-mcp repository.