Document → Markdown Conversion

microsoft

Convert Office documents, PDFs, images, and audio into clean Markdown via the MarkItDown MCP server.

Add to your mcp.json

{
  "mcpServers": {
    "markitdown": {
      "command": "uvx",
      "args": [
        "markitdown-mcp"
      ]
    }
  }
}

mcp_scope:
  attached:
    - markitdown

none

no credentials required; conversions run locally in the subprocess.

No credentials required.

No environment variables required.

markitdown.convert_to_markdown
Convert a local file or URI (Office/PDF/image/audio) to Markdown.

FAI cookbook recipes that attach markitdown.

No destructive tools — audited read-only

Destructive-action audit (X2.18): no destructive tools — conversion is read-only.

Requires `uv` / `uvx` on PATH (Python tooling) rather than Node; the first run resolves the markitdown-mcp package.
Some formats (e.g. audio transcription, image OCR) depend on optional extras that may need extra system dependencies.

Maintainers who landed commits onmcp-specs/markitdown.json.

When this spec was last reviewed by a maintainer and last machine-validated against the live server.