O que é Paperless-NGX MCP Server?
Este é o fork mantido do nloui/paperless-mcp, o servidor MCP original do Paperless-ngx, cujo último commit foi em 11 de novembro de 2025. O fork de Baruch Rothkoff (baruchiro/paperless-mcp) tem cerca de 149 estrelas no GitHub contra 248 do original, mas é o que continua lançando versões: a v2.2.1 saiu em 11 de setembro de 2026, e seu pacote npm teve 683 downloads na semana até 29 de outubro de 2026, contra 171 do original.
Ele encapsula a API REST do Paperless-ngx com cerca de 31 ferramentas que cobrem documentos, notas, etiquetas, correspondentes, tipos de documento, campos personalizados e contas e regras de e-mail. Ele roda via stdio com npx -y @baruchiro/paperless-mcp@latest, ou como imagem Docker que serve Streamable HTTP e SSE na porta 3000. Ele precisa da URL da sua instância do Paperless-ngx e de um token de API obtido na página do seu perfil. O repositório tem licença ISC.
Como instalar Paperless-NGX MCP Server
npx -y @baruchiro/paperless-mcp@latestPaperless-NGX MCP Server vale a pena?
Para quem já guarda cartas, faturas e documentos fiscais no Paperless-ngx, este servidor transforma o arquivo em algo que um agente pode buscar e reorganizar. query_documents repassa busca de texto completo, buscas por documentos semelhantes e consultas estruturadas por campos personalizados, como encontrar todas as faturas sem número de fatura. Isso cobre a maior parte do que uma pessoa faz na interface web.
A lista de ferramentas vai bem além da leitura. bulk_edit_documents pode juntar, dividir, girar, apagar páginas de documentos e apagar documentos, e mudar suas permissões; post_document envia arquivos de até 100 MB; as ferramentas de e-mail criam e editam as regras que decidem o que o Paperless tira da sua caixa de entrada. Só a exclusão de notas e de regras de e-mail pede uma flag de confirmação explícita. Uma exclusão em massa não pede, então o pedido de aprovação do cliente é a única proteção.
O trabalho de segurança do fork é o principal motivo para escolhê-lo em vez do original. A versão 2.0.0 fez o modo HTTP rejeitar requisições sem token Bearer, fechando um endpoint que antes recorria à própria chave do servidor para qualquer chamador na rede. Cada cliente HTTP agora envia seu próprio token do Paperless, então as permissões do Paperless valem por usuário. Envios por caminho de arquivo leem qualquer arquivo que o processo enxergue, a menos que PAPERLESS_MCP_UPLOAD_PATHS os restrinja, e essa variável é opcional.
Os pontos fracos são os de sempre em um servidor da comunidade com um único mantenedor. O Paperless-ngx v3.0.0 abandonou as versões da API REST abaixo da 9, e configurações mais antigas agora recebem erros HTTP 406 até PAPERLESS_API_VERSION ser definida. A documentação é um README longo, e não um site de documentação. O texto de documentos vindos de correspondência digitalizada é entrada não confiável, então um agente que o lê fica exposto a injeção de prompt enquanto tem acesso de escrita ao arquivo.
Onde ele se destaca
Um freelancer com cinco anos de faturas e recibos no Paperless-ngx
Encontrar todas as faturas de 2025 ainda sem número de fatura antes de declarar os impostos
query_documents com uma consulta por campo personalizado lista as lacunas e bulk_edit_documents as etiqueta para acompanhamento. Gratuito sobre uma instalação existente do Paperless; o custo são algumas chamadas de ferramenta e a revisão de cada edição em massa.
Um dono de home lab que digitaliza a correspondência da casa no Paperless
Configurar regras de e-mail para que contas de consumo sejam puxadas do e-mail e etiquetadas automaticamente
O agente lista as contas de e-mail e depois chama create_mail_rule com filtros de remetente e assunto e as etiquetas a atribuir. As senhas das contas são ocultadas na saída das ferramentas, mas uma regra errada pode marcar ou mover e-mails na caixa de entrada real.
Um pequeno escritório de contabilidade que auto-hospeda o Paperless para arquivos de clientes
Dar a duas pessoas da equipe um assistente que respeite quem pode ver os documentos de qual cliente
Rode a imagem Docker no modo HTTP e faça cada cliente enviar seu próprio token do Paperless como cabeçalho Bearer, para que as permissões do Paperless valham por pessoa. Mantenha o servidor fora da internet pública e deixe --no-auth sem definir.
Antes de decidir
- Configuração
- Adicione npx -y @baruchiro/paperless-mcp@latest com PAPERLESS_URL e PAPERLESS_API_KEY à configuração do cliente, ou rode ghcr.io/baruchiro/paperless-mcp para HTTP e SSE na porta 3000. O README tem um link de instalação para o Cursor e um exemplo para o Continue; leva poucos minutos depois que você tem um token.
- Integrações
- Cerca de 31 ferramentas: listar, consultar, baixar e enviar documentos, miniaturas, notas, etiquetas, correspondentes, tipos de documento, campos personalizados e contas e regras de e-mail. Mais ou menos metade delas escreve.
- Dados e privacidade
- Tudo o que o token de API alcança, incluindo exclusão. No modo HTTP, desde a v2.0.0, cada requisição precisa trazer seu próprio token Bearer, a menos que --no-auth esteja definido. Envios por caminho de arquivo leem qualquer arquivo local, a menos que PAPERLESS_MCP_UPLOAD_PATHS esteja definida. Não há alertas de segurança publicados no GitHub.
- Custo em escala
- Gratuito; o Paperless-ngx é auto-hospedado, então os únicos custos são seu servidor e os tokens do modelo. Páginas de resultados grandes e envios em base64 são as principais fontes de inchaço do contexto.
- Limites
- O Paperless-ngx v3.0.0 rejeita versões da API abaixo da 9 com HTTP 406. search_documents está obsoleto em favor de query_documents. Os métodos destrutivos em massa não têm flag de confirmação.
O que é bom
- Cerca de 31 ferramentas, incluindo consultas por campos personalizados e regras de e-mail
- Tokens Bearer por requisição no modo HTTP desde a v2.0.0
- Imagens npx e Docker; testes de ponta a ponta rodam contra um Paperless-ngx real
- Mantido ativamente, ao contrário do repositório original
O que não é
- Exclusão, junção e divisão em massa rodam sem flag de confirmação
- Envios por caminho de arquivo não têm restrição, a menos que você defina uma lista de permissões
- Um único mantenedor; cerca de 149 estrelas
- Configurações antigas recebem HTTP 406 após o Paperless-ngx 3.0
Ideal para
Usuários do Paperless-ngx que querem um agente para encontrar, etiquetar e arquivar documentos e vão manter as chamadas de escrita sob pedidos de aprovação.
Alternativas ao Paperless-NGX MCP Server
Paperless-NGX MCP Server: perguntas frequentes
- Paperless-NGX MCP Server vale a pena?
- O servidor de Paperless-ngx que vale instalar, amplo o bastante para fazer o dia inteiro de um arquivista, e amplo o bastante para apagar seu arquivo se você deixar. Damos nota 3.8 de 5.
- Quanto custa Paperless-NGX MCP Server?
- Gratuito e de código aberto (ISC). O próprio Paperless-ngx é gratuito e auto-hospedado.
- Quais são as desvantagens de Paperless-NGX MCP Server?
- Exclusão, junção e divisão em massa rodam sem flag de confirmação; envios por caminho de arquivo não têm restrição, a menos que você defina uma lista de permissões; um único mantenedor; cerca de 149 estrelas; configurações antigas recebem HTTP 406 após o Paperless-ngx 3.0.
- Para quem Paperless-NGX MCP Server é indicado?
- Usuários do Paperless-ngx que querem um agente para encontrar, etiquetar e arquivar documentos e vão manter as chamadas de escrita sob pedidos de aprovação.
- Quanto custa Paperless-NGX MCP Server para uma equipe ou em produção?
- Gratuito; o Paperless-ngx é auto-hospedado, então os únicos custos são seu servidor e os tokens do modelo. Páginas de resultados grandes e envios em base64 são as principais fontes de inchaço do contexto.
- Paperless-NGX MCP Server é seguro para dados da empresa?
- Tudo o que o token de API alcança, incluindo exclusão. No modo HTTP, desde a v2.0.0, cada requisição precisa trazer seu próprio token Bearer, a menos que --no-auth esteja definido. Envios por caminho de arquivo leem qualquer arquivo local, a menos que PAPERLESS_MCP_UPLOAD_PATHS esteja definida. Não há alertas de segurança publicados no GitHub.
- Quais são as melhores alternativas ao Paperless-NGX MCP Server?
- As alternativas mais próximas que analisamos são Filesystem (reference server), MarkItDown MCP e Zotero MCP.
Respostas verificadas em 31 de out. de 2026.