What can you do with this server?

The Markdownify MCP Server is a tool for converting various file types and web content into Markdown format. * Convert file types to Markdown: PDFs, 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: Get Markdown files by absolute path, optionally restricting access to a specific directory * Integration: Can be integrated with desktop apps through server configuration

Which integrations are available for this server?

Converts various file types and web content to Markdown format Uses Python dependencies through 'uv' for file conversion capabilities Server is built with TypeScript, allowing customization of server behavior Converts YouTube videos to Markdown with transcripts

How do I use Markdownify MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Markdownify MCP Server convert this PDF to markdown" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Markdownify MCP Server

Help! I need someone with a Windows computer to help me add support for Markdownify-MCP on Windows. PRs exist but I cannot test them. Post here if interested.

markdownify mcp logo

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.

Features

Convert multiple file types to Markdown:
- PDF
- 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

Getting Started

Clone this repository
Install dependencies:
pnpm install

Note: this will also install uv and related Python depdencies.

Build the project:
pnpm run build
Start the server:
pnpm start

Development

Use pnpm run dev to start the TypeScript compiler in watch mode
Modify src/server.ts to customize server behavior
Add or modify tools in src/tools.ts

Usage with Desktop App

To integrate this server with a desktop app, add the following to your app's server configuration:

{ "mcpServers": { "markdownify": { "command": "node", "args": [ "{ABSOLUTE PATH TO FILE HERE}/dist/index.js" ], "env": { // By default, the server will use the default install location of `uv` "UV_PATH": "/path/to/uv" } } } }

Available Tools

youtube-to-markdown: Convert YouTube videos to Markdown
pdf-to-markdown: Convert PDF files to Markdown
bing-search-to-markdown: Convert Bing search results to Markdown
webpage-to-markdown: Convert web pages to Markdown
image-to-markdown: Convert images to Markdown with metadata
audio-to-markdown: Convert audio files to Markdown with transcription
docx-to-markdown: Convert DOCX files to Markdown
xlsx-to-markdown: Convert XLSX files to Markdown
pptx-to-markdown: Convert PPTX files to Markdown
get-markdown-file: Retrieve an existing Markdown file. File extension must end with: *.md, *.markdown.
OPTIONAL: set MD_SHARE_DIR env var to restrict the directory from which files can be retrieved, e.g. MD_SHARE_DIR=[SOME_PATH] pnpm run start