Convert MCP Server

A lightweight [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that converts documents to Markdown. Supports PDF, DOCX, HTML

Local serverstdioPython

What is the Convert MCP server?

Convert MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. A lightweight Model Context Protocol (MCP) server that converts documents to Markdown. Supports PDF, DOCX, HTML, EPUB, CSV, JSON, and plain text files.

What you get

  • 📄 Multi-format support: PDF, DOCX, HTML, EPUB, CSV, JSON, images (via OCR), and plain text
  • 🔧 6 MCP tools: convert_file, convert_url, list_supported_formats, batch_convert, extract_metadata, convert_directory
  • 🐍 Zero external dependencies for core: Uses Python standard library + markdownify for HTML
  • Fast: In-memory processing, no temp files
  • 🐳 Docker-ready: Single Dockerfile, one command deploy

What the assistant can call

Once Convert is connected, these are the calls the assistant has available:

  • convert_file — The convert_file tool exposed by this server
  • convert_url — The convert_url tool exposed by this server
  • batch_convert — The batch_convert tool exposed by this server
  • convert_directory — The convert_directory tool exposed by this server
  • extract_metadata — The extract_metadata tool exposed by this server
  • list_supported_formats — List all supported file extensions and their conversion methods

Setting it up

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Choosing this one

Among the cloud and infrastructure options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Convert's toolset — convert_file, convert_url, batch_convert and 3 more — is a fair guide to whether it matches your workflow. It is maintained by demo112; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the convert mcp server does with a few real requests.

Available tools

ToolWhat it does
convert_fileThe convert_file tool exposed by this server.
convert_urlThe convert_url tool exposed by this server.
batch_convertThe batch_convert tool exposed by this server.
convert_directoryThe convert_directory tool exposed by this server.
extract_metadataThe extract_metadata tool exposed by this server.
list_supported_formatsList all supported file extensions and their conversion methods.

How to install the Convert MCP server

{
  "mcpServers": {
    "convert": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "/path/to/files:/data", "mcp-server-convert"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Convert to convert file.
  • Use Convert to convert url.
  • Use Convert to batch convert.

Frequently asked questions

It connects Convert to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (convert_file, convert_url, batch_convert, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Convert directly.