¿Qué es MarkItDown MCP?
MarkItDown es la herramienta de Python de Microsoft para convertir archivos y documentos de ofimática a Markdown; el repositorio principal tiene unas 191.700 estrellas en GitHub. El paquete markitdown-mcp la envuelve como servidor MCP, creado por el equipo de AutoGen.
Expone exactamente una herramienta, convert_to_markdown(uri), que acepta URI http:, https:, file: o data:. Funciona sobre stdio por defecto, o sobre Streamable HTTP y SSE con la opción --http, ligado a localhost. Se instala con pip install markitdown-mcp; para Claude Desktop, el README recomienda construir la imagen de Docker a partir del Dockerfile del repositorio y montar una carpeta para los archivos locales. No figura en el registro oficial de MCP.
El paquete sigue en versiones alfa: la 0.0.1a8 salió el 21 de octubre de 2026 junto con MarkItDown 0.1.9, tras una primera alfa en marzo de 2025.
Cómo instalar MarkItDown MCP
pip install markitdown-mcp¿Merece la pena MarkItDown MCP?
MarkItDown MCP es la forma más barata, en contexto y en dinero, de dejar que un agente local lea archivos de Office y PDF, y su modelo de seguridad se reduce a confiar en todo lo que hay en la máquina. Una sola herramienta supone casi ninguna carga de contexto, y la misma llamada sirve para un archivo local, una URL o datos en línea.
La cobertura de formatos es amplia: PDF, Word, PowerPoint, Excel, EPub, HTML, CSV, JSON y XML, imágenes mediante metadatos EXIF y OCR, audio mediante transcripción, archivos ZIP y URL de YouTube. El paquete MCP fija markitdown[all], así que se instalan todos los conversores opcionales los necesites o no, lo que está detrás de una issue abierta que informa de instalaciones fallidas en Windows ARM64.
La sección de seguridad del README es inusualmente directa. No hay autenticación, el servidor se ejecuta con los privilegios de tu usuario y convert_to_markdown puede leer cualquier archivo que ese usuario pueda leer u obtener cualquier cosa de la red. Si se combina con un agente que lee documentos no fiables, una instrucción inyectada para convertir file:///home/you/.ssh/config es un fallo verosímil. La vía de Docker con una sola carpeta montada es la opción sensata por defecto, aunque la imagen la construyes tú: no se publica ninguna imagen oficial.
Lo que hace peor que sus rivales es todo lo que viene después de la conversión. No hay búsqueda, troceado ni selección de páginas, así que un PDF de 300 páginas llega al contexto de una sola pieza, y el resultado apunta a la estructura del texto más que a una maquetación fiel. Tras 19 meses y ocho alfas, el paquete sigue con una versión 0.0.1, y una issue abierta señala que la galería MCP de VS Code todavía instala la 0.0.1a4.
Dónde se gana su sitio
Una analista financiera en una empresa de 30 personas que usa Claude Desktop
Resumir los paquetes trimestrales de Excel y PowerPoint sin subirlos a una aplicación web
Construye la imagen de Docker, monta solo la carpeta de informes en /workdir y apunta Claude Desktop a docker run. La conversión es gratuita y local; el coste son los tokens del modelo, porque cada libro llega entero.
Un ingeniero de IA que crea un agente de ingesta de documentos con Claude Agent SDK
Convertir en Markdown subidas variadas de clientes antes de trocearlas
Ejecuta markitdown-mcp --http en 127.0.0.1:3001 dentro de un contenedor y pasa las subidas como URI data:, para que el servidor nunca necesite acceso al sistema de archivos. El troceado y la selección de páginas tienen que estar en tu propio código.
Una ingeniera de seguridad que aprueba servidores MCP para los portátiles de los desarrolladores
Decidir si se puede instalar MarkItDown
Permite solo la configuración con Docker, con un directorio montado y sin ligarlo a nada que no sea localhost. Un pip install a secas se ejecuta con todo el acceso a archivos del usuario, así que un documento con instrucciones inyectadas podría hacer que el agente leyera archivos fuera del proyecto.
Antes de decidirte
- Puesta en marcha
- pip install markitdown-mcp (Python 3.10+) y ejecuta markitdown-mcp para stdio, o markitdown-mcp --http --host 127.0.0.1 --port 3001 para Streamable HTTP y SSE. Para Claude Desktop, construye la imagen a partir del Dockerfile y lánzala con docker run. Minutos hasta la primera llamada.
- Integraciones
- Una herramienta, convert_to_markdown(uri), que recibe URI http:, https:, file: o data:. No escribe nada, pero puede leer todo lo que alcance el proceso; MCP Inspector es la vía de depuración documentada.
- Datos y privacidad
- Se ejecuta en local sin cuenta y sin enviar nada a Microsoft. No hay autenticación, y en modo HTTP cualquier proceso o usuario local puede llamarlo. Las páginas y documentos obtenidos son texto no fiable dentro del contexto del modelo.
- Coste a escala
- Gratis con MIT; la factura son los tokens del modelo. Como la herramienta no tiene parámetro de página ni de tamaño, un PDF largo puede ocupar una gran parte de la ventana de contexto en una sola llamada.
- Límites
- Sin paginación, troceado ni búsqueda, y la maquetación se aplana a estructura de texto. Hay issues abiertas sobre fallos de instalación en Windows ARM64 por la dependencia obligatoria markitdown[all] y sobre la galería de VS Code instalando la antigua 0.0.1a4.
Lo bueno
- Una sola herramienta, así que casi ninguna carga de contexto
- Convierte PDF, Office, EPub, HTML, imágenes, audio y ZIP
- Acepta URI file, http(s) y data
- Licencia MIT; Dockerfile para aislarlo
Lo malo
- Sin autenticación; lee cualquier archivo que pueda leer el usuario
- Los documentos completos llegan al contexto, sin paginación
- Sin imagen de Docker publicada; la construyes tú
- Sigue en versión alfa, 0.0.1a8
Ideal para
Desarrolladores que quieren que un agente lea PDF y documentos de Office en local sin subirlos a ninguna parte.
Alternativas a MarkItDown MCP
MarkItDown MCP: preguntas frecuentes
- ¿Merece la pena MarkItDown MCP?
- Un conversor de documentos de una sola herramienta que se gana su sitio, siempre que se ejecute en un contenedor que solo pueda ver los archivos que tú quieras. Le damos un 3.9 sobre 5.
- ¿Cuánto cuesta MarkItDown MCP?
- Gratis y de código abierto (MIT).
- ¿Qué inconvenientes tiene MarkItDown MCP?
- Sin autenticación; lee cualquier archivo que pueda leer el usuario; los documentos completos llegan al contexto, sin paginación; sin imagen de Docker publicada; la construyes tú; sigue en versión alfa, 0.0.1a8.
- ¿Para quién es MarkItDown MCP?
- Desarrolladores que quieren que un agente lea PDF y documentos de Office en local sin subirlos a ninguna parte.
- ¿Cuánto cuesta MarkItDown MCP para un equipo o en producción?
- Gratis con MIT; la factura son los tokens del modelo. Como la herramienta no tiene parámetro de página ni de tamaño, un PDF largo puede ocupar una gran parte de la ventana de contexto en una sola llamada.
- ¿Es MarkItDown MCP seguro para los datos de la empresa?
- Se ejecuta en local sin cuenta y sin enviar nada a Microsoft. No hay autenticación, y en modo HTTP cualquier proceso o usuario local puede llamarlo. Las páginas y documentos obtenidos son texto no fiable dentro del contexto del modelo.
- ¿Cuáles son las mejores alternativas a MarkItDown MCP?
- Las alternativas más cercanas que hemos analizado son Fetch (reference server), Filesystem (reference server) y Firecrawl MCP.
Respuestas comprobadas el 23 oct 2026.