Zovo Bank Statement MCP Server

Analise e interprete extratos bancários (PDF/CSV) com agentes de IA: categorize transações, detecte padrões. Local-first, plano gratuito, $19 pagamento único Pro.

Documentação

All servers · Buy Pro $19 · All 46 for $39 · Source

Duas formas de executá-lo, ambas gratuitas para começar. Abra mcp.zovo.one/mcp/connect, copie a URL do extrato bancário e cole-a em qualquer cliente que aceite uma URL. Ela já contém um token gratuito, então não há nada para instalar, nenhuma conta e nenhum cabeçalho para configurar. A URL é https://mcp.zovo.one/mcp/bank-statement/t/<token>. O token não é opcional: o https://mcp.zovo.one/mcp/bank-statement puro conecta e lista suas ferramentas, mas responde a toda chamada de ferramenta com HTTP 401, então use o link de /mcp/connect ou envie Authorization: Bearer <token>. Ou baixe bank-statement.mcpb e clique duas vezes nele no Claude Desktop.

mcp-bank-statement

No Registro Oficial de MCP (io.github.theluckystrike/bank-statement-csv-categorize-reconcile-ledger).

bank-statement demo

Exporte o CSV do seu banco, diga "importe isto", e o mês fica legível. Este servidor MCP transforma um export bancário em um livro-razão local: ele encontra a linha do cabeçalho sob qualquer preâmbulo que o banco imprima acima dela, descobre qual coluna é a data, qual é o dinheiro e para onde o dinheiro foi, e lê os valores no locale do próprio arquivo, então 1 234,56 do mBank e 1,234.56 de um banco dos EUA se tornam o mesmo número. Um débito é armazenado como negativo e um crédito como positivo, uma única vez, na importação, para que nada a jusante precise adivinhar. Reimportar o mesmo export não adiciona nada: cada linha carrega um hash de sua data, valor, moeda e descrição, com um índice de ocorrência, então dois cafés idênticos em um dia permanecem duas transações, enquanto uma segunda importação do mesmo arquivo permanece zero. Suas regras categorizam as transações conforme elas chegam, os resumos reportam entradas, saídas e o líquido por moeda e nunca misturam moedas, recurring_detect encontra as assinaturas e quanto cada uma custa por ano, e reconcile_expenses compara débitos bancários com os recibos em mcp-expense-tracker para que você veja quais débitos não têm recibo e quais recibos nunca chegaram ao banco. Tudo é um arquivo JSON simples na sua própria máquina; nada é enviado para lugar algum.

Transforme um CSV bancário em um mês categorizado e conciliado no chat, sem necessidade de SaaS de contabilidade.

Perfis bancários: Revolut, Wise, mBank, PKO BP, ING, N26, e um leitor genérico que funciona apenas com os cabeçalhos.

Formatos de arquivo que ele lê sem ser solicitado: UTF-8 e UTF-16 (em qualquer ordem de bytes, como o Excel no Windows salva), finais de linha CRLF, LF e apenas CR, campos entre aspas contendo vírgulas, aspas e quebras de linha, 1.234,56 e 1,234.56, parênteses contábeis (12.50) e um sinal de menos final 12.50- (ambos negativos), e uma mistura de moedas dentro de um único arquivo. Uma célula contendo - ou nada é ignorada e nomeada em skipped_lines em vez de ser lida como zero. Quando a coluna de data é ambígua (03/04/2026 sem nenhum valor acima de 12 em lugar algum), a ordem assumida é declarada na resposta em vez de escolher uma silenciosamente.

Instalação em 60 segundos

A publicação no npm para @theluckystrike/mcp-bank-statement está pendente. Até lá, o pacote de um clique .mcpb ou um clone+build é o caminho funcional, ambos verificados abaixo.

Um clique (.mcpb): baixe bank-statement.mcpb do lançamento mais recente e clique duas vezes nele no Claude Desktop: https://github.com/theluckystrike/mcp-servers/releases/latest

(claude_desktop_config.json):

{
  "mcpServers": {
    "bank-statement": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-bank-statement"]
    }
  }
}

Claude Code:

claude mcp add bank-statement -- npx -y @theluckystrike/mcp-bank-statement

(.cursor/mcp.json):

{
  "mcpServers": {
    "bank-statement": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-bank-statement"]
    }
  }
}

O formulário npx acima começa a funcionar no momento em que o pacote é publicado. Até lá, use o pacote .mcpb acima, ou compile a partir do código-fonte com exatamente estes três comandos:

git clone https://github.com/theluckystrike/mcp-servers.git && cd mcp-servers
npm install
npm run build -w packages/mcp-license -w servers/spreadsheet -w servers/bank-statement

Em seguida, aponte o command do seu cliente para node com um argumento: o caminho absoluto para servers/bank-statement/dist/index.js.

Para executar no modo Pro, defina MCP_LICENSE_KEY no mesmo bloco de configuração, ou chame license_activate uma vez com sua chave.

Ferramentas

FerramentaO que faz
statement_importLê um CSV bancário para o livro-razão. Detecta a linha do cabeçalho sob qualquer preâmbulo, as colunas de data, descrição, valor (ou débito e crédito) e moeda, a ordem da data e o locale numérico. Reporta o que detectou, o que armazenou, quantas linhas eram duplicatas do que já existe, e cada linha ignorada com o motivo
transactions_listLista transações em um intervalo de datas, filtradas por conta, categoria ou uncategorized, com totais por moeda
transactions_searchEncontra transações cuja descrição, contraparte, categoria ou conta contém a consulta. Apenas substring, nunca regex
category_rulesDefine ou lista as regras que categorizam transações. Uma correspondência vazia é recusada, porque marcaria uma categoria em todo o livro-razão. Uma correspondência simples é uma substring sem diferenciar maiúsculas de minúsculas; regex: true compila o padrão apenas se ele não puder fazer retrocesso exponencial, e (a+)+ é recusado e usado como substring. Definir regras as reaplica às transações armazenadas
transaction_categorizeDefine a categoria das transações por id. Nada muda a menos que todos os ids existam
statement_summaryEntradas, saídas e o líquido para um intervalo, agrupados por categoria, mês, conta ou contraparte, sempre por moeda
reconcile_expensesCompara débitos bancários com os recibos em mcp-expense-tracker: mesma moeda, mesmo valor, dentro de uma janela de datas. Reporta correspondências, linhas bancárias sem recibo e recibos que nunca chegaram ao banco. O livro-razão de despesas é apenas lido
recurring_detectEncontra assinaturas e cobranças recorrentes: a mesma contraparte, um valor que mal muda, um ritmo constante. Reporta o ritmo, o valor típico, a próxima data esperada e o custo anualizado. Duas cobranças são um intervalo, então o custo anual é omitido (cadence_confirmed: false) até que uma terceira cobrança o confirme
statement_exportEscreve um intervalo em csv ou json e retorna o caminho. Escrito atomicamente, então uma falha nunca deixa um arquivo pela metade. Substituir um arquivo existente é permitido e reportado (overwrote_existing_file)
accounts_listAs contas importadas, com banco, moedas, contagem de transações, intervalo de datas e último saldo
license_statusMostra o modo gratuito ou Pro
license_activateAtiva uma chave Pro (verificada offline)

O recurso bank://month retorna as entradas, saídas e o líquido deste mês, agrupados por categoria, por moeda. O prompt monthly_review conduz todo o processo de fechamento do mês: totais, linhas não categorizadas, assinaturas, conciliação.

Gratuito vs Pro

GratuitoPro
Contas2ilimitadas
Leitura do históricoúltimos 12 mesestodo ele
Regras de categoria5ilimitadas
Importar, listar, pesquisar, resumirsimsim
reconcile_expensessim, 31 dias por vezqualquer intervalo de datas
recurring_detectsim, últimos 3 meses, 5 cobrançashistórico completo, todas as cobranças
statement_exportnãosim

A importação sempre armazena cada linha, independentemente do nível: descartar linhas silenciosamente na entrada faria o livro-razão discordar do banco. O limite gratuito está no que é lido de volta.

Obtenha o Pro: https://mcp.zovo.one/buy/bank-statement, $19 único para este servidor, $39 para todos os servidores, vitalício. As chaves são verificadas offline; nada é enviado a lugar algum. Ou o pacote de 46 servidores por $39.

Combina com

  • mcp-expense-tracker, registre os recibos e a quilometragem; reconcile_expenses lê esse livro-razão e informa quais débitos bancários não têm recibo por trás.
  • mcp-spreadsheet, este servidor analisa seu CSV bancário com o leitor RFC 4180 do próprio servidor de planilhas e o analisador numérico de locale, então 1 234,56 significa a mesma coisa em ambos. Use-o para fatiar um intervalo exportado.
  • mcp-invoice, o lado da receita: emita a fatura e depois veja o pagamento chegar em statement_summary agrupado por contraparte.

Privacidade

Tudo permanece na sua máquina. Os extratos são analisados localmente e armazenados em um arquivo JSON simples sob ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/bank-statement/. O servidor não faz nenhuma chamada de rede, nem para licenciamento, nem para análise, nem para nada. Excluir esse diretório redefine tudo.

Construído por theluckystrike. Suporte: support@zovo.one

Primeiros cinco minutos

Um prompt que obteve 3 de 3, medido na rodada 27, 2026-09-05. Cole-o exatamente como está escrito.

Import my Revolut export at /private/tmp/uv-r27/fix/revolut-main.csv and reconcile it against my expense log for August 2026, so I can see which card payments have no receipt.

Cole isto no Claude com o servidor conectado.

O que ele fez, medido na rodada 27, 2026-09-05: statement_import leu o export do Revolut sob o nome de conta revolut-main e armazenou 41 transações; o arquivo contém 42 linhas de dados e a linha REVERTED não foi importada.

No nível gratuito para este caminho: 2 contas, 12 meses de transações, 5 regras, resumo e pesquisa, conciliação de 31 dias por vez, detecção de recorrência nos últimos 3 meses (5 cobranças).

Configure no seu cliente

Caminho de configuração exato, entrada e ressalvas: Claude Desktop · Claude Code · Cursor · VS Code · Windsurf · Cline · conectores Claude.ai e Claude Desktop · todos os clientes

Comparado com as alternativas

MCP Bank Statement vs MainBook e bankstatementparser-mcp - qual servidor MCP escolher · todas as comparações

Guias

Como rastrear horas faturáveis dentro do Claude Code e do Cursor · Criar um PDF de fatura a partir de uma mensagem de chat com um servidor MCP · Fazer perguntas sobre um arquivo Excel ou CSV a partir do Cursor ou do Claude · Acompanhar o preço de um produto com o Claude e ser avisado quando ele cair · O que o plano gratuito inclui e o que o Pro adiciona · Registrar despesas e quilometragem no Claude, dividir o IVA, cobrar novamente em uma fatura · Converter moedas no Claude com taxas reais do BCE, sem chave de API · Gerar propostas e contratos em Word a partir de uma mensagem de chat · Encontrar um horário de reunião entre fusos horários sem fazer a aritmética · Escrever um currículo e uma carta de apresentação a partir do chat, sem inventar nada · Cobrar um retentor em um cronograma sem um SaaS de faturamento · Montar um contrato a partir da sua própria biblioteca de cláusulas, no chat · Conectar servidores MCP ao Claude.ai, Claude Desktop, Cursor e VS Code sem instalar nada · Mesclar, dividir e carimbar PDFs a partir do chat, e por que alguns voltam como números de glifos · Ler um calendário .ics no Claude: livre e ocupado, conflitos e reuniões faturáveis · Executar um quadro kanban no Claude, com rastreamento de tempo na mesma tarefa · Redimensionar, compactar e adicionar marca d'água em imagens a partir de uma mensagem de chat · Categorizar e conciliar uma exportação CSV de banco a partir do chat · Enviar um orçamento a partir do chat e transformar o "sim" em uma fatura · Colocar um código QR de pagamento SEPA em uma fatura a partir do chat · Compactar e descompactar arquivos com segurança a partir do Claude ou do Cursor · Depósitos de clientes e retentores a partir do chat, aplicados às suas faturas reais · Ativos fixos e depreciação a partir do chat, com as taxas publicadas pelas autoridades fiscais · Diárias e ajudas de custo de viagem a partir do chat, com as tabelas de taxas publicadas pelas autoridades fiscais · Um razão contábil de partidas dobradas a partir de todos os servidores que você já executa · Cronogramas de empréstimos e arrendamentos a partir do chat, fechando exatamente em zero · Ordens de serviço e cartões de trabalho a partir do chat, e por que o markup vai no custo unitário · Listas de preços e tabelas de tarifas a partir do chat, e a lacuna de escala de 100x entre a fatura e o orçamento · Ordens de alteração e o valor do contrato em andamento a partir do chat, e por que uma linha alterada são dois itens · Um fundo de caixa pequeno a partir do chat, e por que o cheque não é a soma dos comprovantes · Extratos de clientes e cobranças de pagamento a partir do chat, com vencimento em qualquer data que você indicar · Notas de crédito e ordens de compra a partir do chat, contra suas faturas reais · Uma instalação, todos os servidores: o pacote de suíte de escritório · Fechar um mês no chat: fatura, nota de crédito, retentor, conciliação bancária, extrato · Servidor MCP não aparecendo no Claude Desktop: as seis verificações que o encontram · Onde está o claude_desktop_config.json e o que vai nele · claude mcp add: todas as flags e o escopo que silenciosamente perde seu servidor · Servidores MCP no Windows: spawn npx ENOENT, barras invertidas e o PATH · Instalando estes servidores MCP quando o npx ainda não funciona · Configuração MCP no Cursor: mcp.json, o campo de tipo obrigatório e onde os servidores aparecem · Quais servidores MCP funcionam sem nenhuma rede · Faturando um cliente da UE com reverse charge, a partir de uma mensagem de chat · Orçamento, depósito, fatura, extrato: todo o ciclo em uma única conversa · Este projeto está dando lucro? Horas contra custos, sem planilha · Montando um pacote de ano fiscal para seu contador a partir do chat · Mantendo um registro de quilometragem no chat, com a taxa que você realmente cobra · Conciliando um CSV de banco contra o que você faturou e gastou · Cobrando novamente despesas de clientes, com markup e o IVA tratado com honestidade · Cobrando uma fatura não paga: vencimento e depois a carta · Uma nota de venda a partir do chat, com os identificadores verificados e as linhas de assinatura impressas · Precificando um trabalho a partir de uma tabela de tarifas e o que fazer quando o escopo muda · Calculando sua taxa horária a partir do que você realmente faturou · Convertendo CSV para xlsx e vice-versa sem abrir o Excel · Fazendo perguntas a uma planilha em linguagem simples · Mesclando uma pasta de recibos em um único PDF a partir do chat · Dividindo uma única digitalização grande em documentos separados · Enviando um mês de papelada como um único arquivo, com segurança · Servidores MCP no VS Code: o erro de uma palavra que quebra toda configuração · Servidores MCP no Windsurf e no Cline: dois padrões que desperdiçam uma tarde · Servidor MCP local ou URL hospedada: qual escolher e o que você abre mão · O que estes servidores MCP realmente fazem no plano gratuito · Escolhendo um servidor MCP para faturamento: as sete perguntas que valem a pena fazer · Quando você precisa de um servidor MCP e quando um prompt é suficiente · Locais de arquivos de configuração MCP e chaves JSON, para cada cliente · Por que um servidor MCP não aparece, em ordem de probabilidade · Como a pesquisa do registro MCP realmente funciona, medida · O que realmente está no registro MCP: 6.000 linhas contadas · stdio ou streamable HTTP: qual transporte MCP e o que quebra · Versões do protocolo MCP: o que cada uma mudou · Cada campo em uma entrada de configuração de servidor MCP, por cliente · Escopos de configuração MCP: qual definição vence quando um servidor é definido duas vezes · Onde cada cliente MCP grava seus logs · Enviando um servidor MCP: um pacote para baixar ou uma URL para colar · O que há dentro de um pacote MCP .mcpb · Cobrando por um servidor MCP: como o licenciamento realmente funciona · Quanto texto um servidor MCP pode retornar e quanto ele pode descrever · O que verificar antes de deixar um servidor MCP rodar · Por que um diretório diz que seu servidor MCP hospedado não está respondendo · O registro MCP vincula uma URL remota a um nome de servidor · Letras maiúsculas no seu nome de usuário do GitHub mudam sua classificação no registro MCP · Quantos servidores MCP já têm sua palavra no nome · Referência de campos do server.json para o registro MCP · Quando uma ferramenta MCP falha, não retorne um erro JSON-RPC · structuredContent e outputSchema no MCP, e o que DEVE ser mantido · Regras para nomear uma ferramenta MCP e a colisão que ninguém planeja · MCP não tem sessão, então como duas chamadas de ferramenta compartilham estado · x-mcp-header: espelhando parâmetros de ferramenta em cabeçalhos HTTP · Como um diretório pontua um servidor MCP e por que sua pior ferramenta decide isso · O que os rastreadores de IA buscam que o Googlebot não busca, medido em 141 URLs · A API de Inspeção de URL do Search Console muda sua resposta entre chamadas · Quais servidores MCP funcionam colando uma URL, sem instalar nada · Onde encontrar servidores MCP que custam dinheiro e como você realmente paga · Fazendo um assistente preencher um orçamento ou estimativa para um cliente · Existe um servidor MCP para livro caixa ou razão de caixa · Conversão de moeda em um assistente e qual servidor MCP usar · Compactando e descompactando arquivos a partir de um assistente e o que as proteções fazem · Produzindo um cronograma de entrega ou um documento de ordem de serviço a partir de um chat · Um servidor MCP enviará a fatura por e-mail para meu cliente · Um assistente pode ler uma foto de um recibo e registrar a despesa · Qual servidor MCP pode gerar PDFs de fatura a partir de uma mensagem de chat? · Um servidor MCP pode ler um PDF de extrato bancário e categorizar as transações? · Melhores servidores MCP para contabilidade e papelada de pequenas empresas em 2026 · Diretório de Fornecedores MCP: evite que listas de fornecedores apodreçam em uma planilha · Contrato de Serviço MCP: pare de copiar um modelo de contrato podre da internet · Registro de Manutenção MCP: saiba qual manutenção é devida sem que ninguém precise lembrar · Registro de Quilometragem MCP: mantenha o registro dedutível no momento da viagem, não em abril · Melhores práticas de condições de pagamento de faturas: Net 30, data de vencimento e multas por atraso · Como categorizar transações bancárias · Modelo de registro de caixa pequeno · Todos os guias

Mais servidores

Servidor MCP para Requisições de Compra — Aprovações a partir do Claude · MCP Leave · Servidor MCP de Rastreamento de Tempo — Grátis, Sem Instalação · MCP Price Tracker · MCP Spreadsheet · Servidor MCP para Faturas — Gere Faturas a partir do Claude · MCP Expense Tracker — Registre Despesas a partir do Claude · MCP Currency Converter