MarkItDown MCP Server logo

MarkItDown MCP Server

by KorigamiK

A Model Context Protocol (MCP) server that converts various file formats to Markdown using the MarkItDown utility. It supports a wide range of formats, making it versatile for different document types.

View on GitHub

Last updated: N/A

What is MarkItDown MCP Server?

MarkItDown MCP Server is an MCP server that leverages the MarkItDown utility to convert various file formats into Markdown. It allows MCP clients to easily convert documents, images, and other data types into a standardized Markdown format.

How to use MarkItDown MCP Server?

The server can be installed either via Smithery or manually by cloning the repository and installing dependencies. Once installed, it can be integrated with any MCP client. For example, with Zed Editor, you need to configure the settings.json file to point to the server's executable. The server responds to the /md <file> command to convert the specified file to Markdown.

Key features of MarkItDown MCP Server

  • Supports a wide range of file formats including PDF, PowerPoint, Word, Excel, Images, Audio, HTML, Text-based formats, and ZIP files

  • Integrates with any MCP-compliant client

  • Provides a simple command-line interface for conversion

  • Automates the process of converting various file types to Markdown

  • Supports EXIF metadata and OCR for images, and speech transcription for audio

Use cases of MarkItDown MCP Server

  • Converting documents to Markdown for editing and formatting

  • Extracting text from images using OCR and converting it to Markdown

  • Transcribing audio files and converting the transcript to Markdown

  • Integrating with editors and tools to provide Markdown conversion functionality

  • Automating document processing workflows

FAQ from MarkItDown MCP Server

What file formats are supported?

The server supports PDF, PowerPoint, Word, Excel, Images (EXIF metadata and OCR), Audio (EXIF metadata and speech transcription), HTML, Text-based formats (CSV, JSON, XML), and ZIP files.

How do I install the server?

You can install it via Smithery using the provided command, or manually by cloning the repository and installing dependencies using uv install.

How do I use the server with Zed Editor?

Add the provided configuration to your settings.json file, pointing to the server's executable.

What command do I use to convert a file?

Use the /md <file> command, replacing <file> with the path to the file you want to convert.

Is this server compatible with other MCP clients?

Yes, it works with any MCP-compliant client listed at modelcontextprotocol.io/clients.