O que é MarkItDown MCP?
O MarkItDown é a ferramenta em Python da Microsoft para converter arquivos e documentos de escritório em Markdown; o repositório principal tem cerca de 191.700 estrelas no GitHub. O pacote markitdown-mcp o empacota como servidor MCP, feito pela equipe do AutoGen.
Ele exp õe exatamente uma ferramenta, convert_to_markdown(uri), que aceita URIs http:, https:, file: ou data:. Roda via stdio por padrão, ou via Streamable HTTP e SSE com a flag --http, escutando no localhost. Instale com pip install markitdown-mcp; para o Claude Desktop, o README recomenda construir a imagem Docker a partir do Dockerfile do repositório e montar uma pasta para os arquivos locais. Ele não está listado no registro oficial de MCP.
O pacote ainda tem versão alpha: a 0.0.1a8 saiu em 21 de outubro de 2026, junto com o MarkItDown 0.1.9, depois de uma primeira alpha em março de 2025.
Como instalar MarkItDown MCP
pip install markitdown-mcpMarkItDown MCP vale a pena?
O MarkItDown MCP é o jeito mais barato, em contexto e em dinheiro, de deixar um agente local ler arquivos do Office e PDFs, e seu modelo de segurança se resume a confiar em tudo o que há na máquina. Uma ferramenta significa quase nenhum custo de contexto, e a mesma chamada lida com um arquivo local, uma URL ou dados inline.
A cobertura de formatos é ampla: PDF, Word, PowerPoint, Excel, EPub, HTML, CSV, JSON e XML, imagens por metadados EXIF e OCR, áudio por transcrição, arquivos ZIP e URLs do YouTube. O pacote MCP fixa markitdown[all], então todos os conversores opcionais são instalados, precise você deles ou não, o que está por trás de uma issue aberta que relata falhas de instalação no Windows ARM64.
A seção de segurança do README é incomumente direta. Não há autenticação, o servidor roda com os privilégios do seu usuário e o convert_to_markdown pode ler qualquer arquivo que esse usuário consiga ler ou buscar qualquer coisa na rede. Coloque isso ao lado de um agente que lê documentos não confiáveis, e uma instrução injetada para converter file:///home/you/.ssh/config é uma falha plausível. O caminho pelo Docker com uma única pasta montada é o padrão sensato, embora você mesmo construa a imagem: nenhuma imagem oficial é publicada.
O que ele faz pior que os concorrentes é tudo o que vem depois da conversão. Não há busca, divisão em blocos nem seleção de páginas, então um PDF de 300 páginas cai no contexto de uma vez, e a saída mira a estrutura do texto, não a fidelidade ao layout. Depois de 19 meses e oito alphas, o pacote ainda carrega a versão 0.0.1, e uma issue aberta observa que a galeria MCP do VS Code ainda instala a 0.0.1a4.
Onde ele se destaca
Um analista financeiro em uma empresa de 30 pessoas que usa o Claude Desktop
Resumir pacotes trimestrais em Excel e PowerPoint sem enviá-los a um app web
Construa a imagem Docker, monte só a pasta de relatórios em /workdir e aponte o Claude Desktop para docker run. A conversão é gratuita e local; o custo são os tokens do modelo, já que cada planilha chega inteira.
Uma engenheira de IA criando um agente de ingestão de documentos no Claude Agent SDK
Transformar uploads variados de clientes em Markdown antes da divisão em blocos
Rode markitdown-mcp --http em 127.0.0.1:3001 dentro de um contêiner e passe os uploads como URIs data:, para que o servidor nunca precise de acesso ao sistema de arquivos. A divisão em blocos e a seleção de páginas precisam ficar no seu próprio código.
Um engenheiro de segurança que aprova servidores MCP para laptops de desenvolvedores
Decidir se o MarkItDown pode ser instalado
Permita só a configuração Docker com um diretório montado e sem escuta fora do localhost. Um pip install puro roda com o acesso total do usuário aos arquivos, então um documento com instruções injetadas poderia fazer o agente ler arquivos fora do projeto.
Antes de decidir
- Configuração
- pip install markitdown-mcp (Python 3.10+) e rode markitdown-mcp para stdio, ou markitdown-mcp --http --host 127.0.0.1 --port 3001 para Streamable HTTP e SSE. Para o Claude Desktop, construa a imagem a partir do Dockerfile e inicie-a com docker run. Minutos até a primeira chamada.
- Integrações
- Uma ferramenta, convert_to_markdown(uri), que recebe URIs http:, https:, file: ou data:. Ela não grava nada, mas pode ler tudo o que o processo alcança; o MCP Inspector é o caminho de depuração documentado.
- Dados e privacidade
- Roda localmente, sem conta e sem nada enviado à Microsoft. Não há autenticação, e no modo HTTP qualquer processo ou usuário local pode chamá-lo. Páginas e documentos buscados são texto não confiável no contexto do modelo.
- Custo em escala
- Gratuito sob MIT; a conta é de tokens do modelo. Como a ferramenta não tem parâmetro de página ou tamanho, um PDF longo pode ocupar uma grande parte da janela de contexto em uma única chamada.
- Limites
- Sem paginação, divisão em blocos ou busca, e o layout é achatado em estrutura de texto. Issues abertas relatam falhas de instalação no Windows ARM64 causadas pela dependência obrigatória markitdown[all] e a galeria do VS Code instalando a antiga 0.0.1a4.
O que é bom
- Uma ferramenta, então quase nenhum custo de contexto
- Converte PDF, Office, EPub, HTML, imagens, áudio e ZIP
- Aceita URIs file, http(s) e data
- Licença MIT; Dockerfile para isolamento
O que não é
- Sem autenticação; lê qualquer arquivo que o usuário possa ler
- Documentos inteiros caem no contexto, sem paginação
- Nenhuma imagem Docker publicada; você mesmo a constrói
- Ainda em versão alpha, 0.0.1a8
Ideal para
Desenvolvedores que querem um agente para ler PDFs e documentos do Office localmente, sem enviá-los a lugar nenhum.
Alternativas ao MarkItDown MCP
MarkItDown MCP: perguntas frequentes
- MarkItDown MCP vale a pena?
- Um conversor de documentos de uma só ferramenta que justifica seu lugar, desde que rode em um contêiner que enxergue só os arquivos que você quer. Damos nota 3.9 de 5.
- Quanto custa MarkItDown MCP?
- Gratuito e de código aberto (MIT).
- Quais são as desvantagens de MarkItDown MCP?
- Sem autenticação; lê qualquer arquivo que o usuário possa ler; documentos inteiros caem no contexto, sem paginação; nenhuma imagem Docker publicada; você mesmo a constrói; ainda em versão alpha, 0.0.1a8.
- Para quem MarkItDown MCP é indicado?
- Desenvolvedores que querem um agente para ler PDFs e documentos do Office localmente, sem enviá-los a lugar nenhum.
- Quanto custa MarkItDown MCP para uma equipe ou em produção?
- Gratuito sob MIT; a conta é de tokens do modelo. Como a ferramenta não tem parâmetro de página ou tamanho, um PDF longo pode ocupar uma grande parte da janela de contexto em uma única chamada.
- MarkItDown MCP é seguro para dados da empresa?
- Roda localmente, sem conta e sem nada enviado à Microsoft. Não há autenticação, e no modo HTTP qualquer processo ou usuário local pode chamá-lo. Páginas e documentos buscados são texto não confiável no contexto do modelo.
- Quais são as melhores alternativas ao MarkItDown MCP?
- As alternativas mais próximas que analisamos são Fetch (reference server), Filesystem (reference server) e Firecrawl MCP.
Respostas verificadas em 23 de out. de 2026.