markitdown-auto

Plugin Claude Code que economiza 5-10x em tokens ao processar arquivos binários/estruturados.

Sempre que o Claude tenta usar Read num arquivo PDF/DOCX/PPTX/XLSX/EPUB, esse hook intercepta e instrui ele a usar o MarkItDown MCP da Microsoft — que converte o arquivo localmente pra Markdown e só manda o texto limpo pro modelo.

Já vem com o Claude Code. Nada pra instalar.

Instala uma vez (global):

claude mcp add markitdown --scope user -- uvx --from markitdown-mcp markitdown-mcp

Requer uv (recomendado) ou pip install markitdown-mcp.

Verifica se conectou:

claude mcp list

Deve mostrar markitdown: ... - ✓ Connected.

Dentro do Claude Code:

/plugin marketplace add gestordeaudiencia/markitdown-auto
/plugin install markitdown-auto@markitdown-auto

Depois reinicia o Claude Code (ou abre /hooks uma vez pro watcher pegar).

• PDF (.pdf)
• Word (.docx, .doc)
• PowerPoint (.pptx)
• Excel (.xlsx, .xls)
• EPub (.epub)

Todos outros formatos passam normalmente pelo Read nativo.

Por que funciona no Windows sem adaptação:

• Hook escrito em Node.js puro (sem bash, jq, ou shell-ismos)
• pathToFileurl() do Node é platform-aware — converte C:\Users\... pra file:///C:/Users/... automaticamente
• Path do script com aspas no hooks.json — suporta pastas com espaço (ex: C:\Users\João Silva\...)
• Line endings forçados pra LF via .gitattributes (evita quebra em scripts checkout no Windows)

/plugin disable markitdown-auto@markitdown-auto

markitdown-auto/
├── .claude-plugin/
│   └── marketplace.json
├── markitdown-auto/
│   ├── .claude-plugin/
│   │   └── plugin.json
│   └── hooks/
│       ├── hooks.json
│       └── markitdown-redirect.js
└── README.md

MIT