Markitdown MCP

Markitdown

Convierte PDFs, Word, Excel, PowerPoint y más a Markdown. Ideal para agentes que no pueden leer archivos binarios.

Instalado via Nix: nix profile install nixpkgs#markitdown-mcp (o usando home manager en unstable)

Expone una sola herramienta: convert_to_markdown(uri), donde uri puede ser file://, http://, https:// o data:.

Zed Editor

En ~/.config/zed/settings.json:

{
  /// Configure an MCP server that runs locally via stdin/stdout
  ///
  /// The name of your MCP server
  "markitdown": {
    /// The command which runs the MCP server
    "command": "path/completo/a/markitdown-mcp",
    /// The arguments to pass to the MCP server
    "args": [],
    /// The environment variables to set
    "env": {}
  }
}

Verifica que esté activo: Agent Panel → punto verde al lado del nombre del servidor.

Uso: el agente llama la herramienta automáticamente. También puedes pedírselo explícitamente:

lee este PDF: file:///home/user/docs/guia.pdf

Claude Code

claude mcp add markitdown -- markitdown-mcp

Con scope global (disponible en todos los proyectos):

claude mcp add markitdown --scope user -- markitdown-mcp

Verificar:

claude mcp list

Gemini CLI

gemini mcp add markitdown -- markitdown-mcp

Con scope global:

gemini mcp add markitdown --scope user -- markitdown-mcp

Verificar:

gemini mcp list

Nota: No uses guiones bajos en el nombre del servidor. Usar markitdown no markitdown_mcp.

Opencode

opencode mcp add

Luego rellenar informacion

• Nombre: markitdown
• Commando: markitdown-mcp

opencode mcp list

Uso

En cualquiera, pasar el archivo como file:// URI:

convert_to_markdown("file:///ruta/absoluta/al/archivo.pdf")

Formatos soportados: PDF, DOCX, XLSX, PPTX, HTML, CSV, JSON, imágenes, audio, ZIP, YouTube URLs.