Organizze
Conecte suas finanças reais do Organizze diretamente no Claude, ChatGPT ou Manus.
What it can do
- List Accounts: Lista as contas do usuário com ids.
- List Credit Cards: Lista os cartões de crédito do usuário com ids e limites.
- List Categories: Lista as categorias usadas para classificar transações.
What data it sees
Do you need an account
No: the server works without sign-in
Conecte suas finanças reais do Organizze diretamente no Claude, ChatGPT ou Manus. Consulte saldos, faturas, limites de cartões e crie transações usando linguagem natural, com conexão segura via OAuth e controle total da sua conta.
How to connect
How to connect Organizze to Claude
The server address to paste into Claude settings:
https://finance--organizze.run.tools
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect Organizze to ChatGPT
The server address to paste into ChatGPT settings:
https://finance--organizze.run.tools
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect Organizze to Cursor
The server address to paste into Cursor settings:
https://finance--organizze.run.tools
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (60)
Raw names from tools/list. Only developers need these.
| list_accounts | Lista as contas do usuário com ids. |
| list_credit_cards | Lista os cartões de crédito do usuário com ids e limites. |
| list_categories | Lista as categorias usadas para classificar transações. |
| list_transactions | Lista transações do usuário no período selecionado, com paginação (page/per_page; máximo 80 por página). Detalhes Open Finance (dados crus do banco) não são incluídos nesta listagem para economizar contexto; use get_transaction com o id para ver um lançamento completo. IMPORTANTE: Para análise de gastos por categoria, use list_mode='all_transactions' ou informe category_id (auto-switch). O modo 'cashflow' (padrão) mostra fluxo de caixa e NÃO inclui gastos individuais do cartão de crédito. O modo 'all_transactions' inclui TODAS as transações incluindo gastos no cartão de crédito com suas categorias. PAGINAÇÃO: Se truncated=true, há mais itens — chame de novo com page+1 ou use filtros mais estreitos. TOTAIS: o campo period_totals já traz receitas/despesas/resultado do PERÍODO COMPLETO com o filtro atual — use-o para somas; NUNCA some as linhas de uma página truncada; para agregados mais ricos (saldo, previsto) use transactions_list_results. LIMITE: Se houver muitas transações no período, use filtros (datas, conta, categoria) ou ferramentas de relatório (ex.: get_categories_report) em vez de pedir o ano inteiro sem filtro. INTERPRETAÇÃO DO STATUS PAGO/PENDENTE: Transações de contas MANUAIS (automatic=false): 'paid' reflete se o usuário marcou como paga. Se paid=false E date < data atual → transação ATRASADA. Se paid=false E date >= data atual → transação A VENCER. Transações de contas AUTOMÁTICAS/conectadas (automatic=true): 'paid' é sempre true (banco já confirmou). IGNORE o campo paid para análise de contas atrasadas/vencendo nestas transações. Faturas de cartão (type=CreditCardInvoice): podem estar genuinamente pendentes ou atrasadas mesmo em cartões automáticos. Verifique o campo 'paid' normalmente. |
| list_transferences | Lista transferências entre contas com paginação (page/per_page). Datas em YYYY-MM-DD. |
| list_budgets | Lista limites de gastos por categoria. Passe year e/ou month para escopo. |
| get_credit_card_invoices | Lista faturas de um cartão. Informe credit_card_id. |
| get_financial_summary | Resumo financeiro do período (receitas, despesas, comparação, maiores gastos). Totais em base caixa; maiores gastos em base por lançamento (incluem cartão) — não somam com os totais. |
| search_transactions | Busca transações por texto na descrição, observação ou tags (ex.: "iFood", "Uber", "salário"). Paginação via page/per_page; sem datas, o padrão são os últimos 6 meses. |
| get_transaction | Detalhes completos de uma transação pelo id ou uuid. |
| get_credit_card_invoice | Detalhes de uma fatura específica de cartão: transações, pagamentos e gastos por categoria. Prefira passar credit_card com o NOME do cartão. |
| get_budget_summary | Resumo dos limites de gastos do mês com alertas de budgets excedidos ou próximos do limite ("estou no controle?"). Padrão: mês atual. |
| get_income_vs_expenses | Relatório de entradas vs saídas (receitas vs despesas) por período, em modo cashflow. Use account_id para filtrar uma conta. Padrão: mês atual. Base caixa por conta — exclui compras individuais de cartão (só pagamentos de fatura). |
| transactions_list_results | Totais financeiros de um período (receitas, despesas, resultado, saldo, previstos) sem paginar transação por transação. Ideal para "quanto gastei esse mês?", "qual meu saldo?". Padrão: mês atual. Base caixa por padrão (inclui pagamentos de fatura, não compras de cartão); com category_id muda para base por lançamento. Não reconcilie bases diferentes. |
| suggest_categories | Sugere categorias para uma ou mais descrições de transação, usando as edições anteriores do próprio usuário, o histórico já categorizado e padrões globais. Use ANTES de create_transaction ao classificar um lote de descrições. Cada item retorna confidence e semantic_strength para decidir entre aplicar ou confirmar. |
| get_account_context | Orientação inicial em uma só chamada: entidade conectada, plano, data de hoje no fuso do usuário, e listas compactas (id ↔ nome) de contas, cartões e categorias. Chame no início para evitar várias chamadas list_*. |
| resolve_entity | Resolve um nome aproximado para o id/uuid real de conta, cartão ou categoria. Use ANTES de uma escrita para evitar ids inventados. Quando ambíguo, retorna as correspondências. |
| get_upcoming_bills | Contas a pagar dos próximos dias: lançamentos não pagos com vencimento na janela e faturas de cartão que vencem no período ("o que vence essa semana?"). Padrão: 7 dias. |
| get_monthly_overview | Visão geral do mês em uma só chamada: receitas, despesas, saldo, maiores categorias de despesa, status dos limites e contas a pagar dos próximos 7 dias. Padrão: mês atual. totals são base caixa; top_expense_categories são base por lançamento e NÃO somam com totals.expenses. |
| get_categories_report | Relatório de gastos e receitas agrupados por categoria (inclui compras de cartão; base POR LANÇAMENTO). Percentuais e subcategorias. Padrão: mês atual. |
| get_categories_evolution | Evolução de gastos/receitas por categoria ao longo do tempo (diário/semanal/mensal). Ideal para tendências. Padrão: últimos 3 meses. |
| get_tags_report | Relatório de transações agrupadas por tag (despesas e receitas, com percentuais). Para projetos/históricos longos informe start_date e end_date amplos — o padrão é só o mês atual. |
| get_invoices_matrix | Matriz de faturas (mês × cartão) com totais por mês, por cartão e total geral, usando os mesmos valores de get_credit_card_invoices. Use quando o usuário pedir faturas de VÁRIOS cartões e/ou meses, em vez de somar à mão. Padrão: ano atual, todos os cartões. |
| find_duplicates | Encontra transações possivelmente duplicadas (mesmo valor e descrição similar em datas próximas). Útil para limpeza de lançamentos em dobro. Padrão: mês atual. |
| find_installments | Encontra COMPRAS PARCELADAS no período (use isto, não busca por texto). Combina parcelas estruturadas e heurística para Open Finance (apresentadas como "possível parcelamento"). Sem datas, últimos 12 meses. Pode filtrar por conta/cartão. |
| find_subscriptions | Detecta ASSINATURAS e serviços recorrentes (Netflix, Spotify, ChatGPT, aluguel...). Use para "minhas assinaturas", "o que pago todo mês", "o que posso cancelar". Funciona em contas/cartões CONECTADOS (Open Finance), onde não há cadastro de recorrência: combina contas fixas cadastradas e heurística (mesmo estabelecimento repetido em vários meses). Classifica por estabilidade do valor (assinatura vs recorrente variável). NÃO inclui parcelamentos (use find_installments). Sem datas, últimos 6 meses. |
| get_bank_connections | Lista as conexões bancárias (Open Finance / Conectado) ATIVAS e o status de cada uma (estável/indisponível). Somente leitura — não força sincronização. Use para "meu banco não atualiza". |
| get_open_finance_status | Status AO VIVO do agregador Open Finance (Belvo), opcionalmente por banco. Use para saber se "o banco não atualiza" é uma instabilidade upstream. Cacheado ~5 min. |
| get_latest_imports | Transações mais recentemente importadas via Open Finance (contas/cartões conectados). Use para "lançamentos novos/recém-importados". Paginação via page/per_page (padrão 50, máx 100). |
| get_balances | Saldo consolidado: saldo atual de cada conta, fatura atual em aberto de cada cartão e o patrimônio (contas − faturas atuais em aberto). Base caixa; não trata parcelas/faturas futuras como dívida. Use para "qual meu saldo total", "quanto tenho", "patrimônio". |
| get_cashflow_forecast | Projeção de fluxo de caixa: parte do saldo atual e aplica os lançamentos não pagos de contas manuais na janela, retornando o saldo projetado ao fim e o menor ponto (risco de negativo). Base caixa; não projeta faturas de cartão. Padrão: próximos 30 dias. |
| list_recurrences | Lista as contas fixas CADASTRADAS (lançamentos recorrentes/infinitos): aluguel, assinaturas, salário, etc., com periodicidade, valor e a próxima ocorrência. Só traz recorrências cadastradas (contas/cartões MANUAIS); em conectados (Open Finance) volta vazio — para assinaturas use find_subscriptions. NÃO inclui parcelamentos (use find_installments). |
| list_institutions | Catálogo de instituições financeiras (bancos/operadoras) com o id (slug) usado em institution_id ao criar/editar contas e cartões. Use query para filtrar por nome. |
| load_skill | Carrega um guia detalhado de uso (skill) sobre um tema do Organizze. Chame ANTES de responder quando a conversa tocar um destes temas: - automatic_card_invoice_payments: Pagamento de fatura de cartão AUTOMÁTICO (Open Finance): usuário diz que pagou a fatura de cartão conectado — fluxo inform_invoice_payment e prazos de sincronização. - bulk_transaction_operations: Operações em lote sobre transações existentes: recategorizar, atualizar descrições/tags, duplicatas e limites das ferramentas mass_* / update_transactions_*. - category_and_budget_management: Gerenciar categorias, subcategorias e orçamentos: criar, reorganizar, arquivar, mesclar, limites de gasto e reestruturação do plano de categorias. - credit_card_invoice_queries: Consultas de fatura de cartão: vencimento, fechamento, status pago/aberto e semântica de 'pago' quando a pergunta envolve despesas não pagas com cartões. - credit_card_spending: Análise de gastos no cartão de crédito: listar/filtrar compras por cartão, categorias no cartão e comparação entre faturas. - financial_health: Diagnóstico de saúde financeira: 'está tudo ok?', onde economizar, tendências de gastos — sempre incluindo cartões na análise. - financial_summaries_and_bases: Resumos financeiros do período: quanto gastei/recebi, saldo, visão geral, previsto vs. realizado e bases corretas de cálculo. - installments_search: Encontrar compras parceladas e parcelas restantes: estratégia correta com find_installments. - invoice_payments: Pagamento de fatura de cartão MANUAL: register_invoice_payment — nunca create_transaction para pagar fatura. - latest_open_finance_imports: Importações recentes Open Finance: listar novidades e marcá-las como lidas (clear_latest_imports / remove_from_latest_imports). - open_finance_accounts: Contas e cartões conectados (Open Finance): conciliação e enriquecimento de dados sincronizados sem duplicar importação. - subscriptions_detection: Detectar assinaturas e serviços recorrentes: 'o que pago todo mês', streamings repetidos, o que cancelar. - support_and_connection_issues: Suporte e problemas de conexão Open Finance: banco não atualiza/não sincroniza e canais oficiais de ajuda. - sync_accounts_and_cards: 'Sincronizar/copiar/espelhar' transações entre contas ou cartões sem duplicar (fluxo seguro anti-duplicação). - transaction_listing_and_search: Busca e listagem de transações: períodos, tags, modos list_mode (cashflow vs all_transactions), paginação e truncamento. |
| create_transaction | Cria uma transação (receita ou despesa). Passe o nome da conta em account. |
| create_account | Cria uma conta bancária manual. |
| inform_invoice_payment | Informa pagamento de fatura em cartão automático (Open Finance). |
| update_transaction | Atualiza uma transação existente (informe só os campos a alterar). Em transações automáticas só descrição, categoria, observação e tags podem mudar. Prefira NOMES de conta/categoria (não invente ids). |
| delete_transaction | Exclui uma transação. Transações automáticas (Open Finance) não podem ser excluídas. Para recorrentes use delete_recurrence. Ação destrutiva — informe o id/uuid exato. |
| set_transaction_paid | Marca uma transação como paga/recebida (paid=true) ou não paga (paid=false) em conta MANUAL ("já paguei o aluguel"). Idempotente. Transações automáticas são sempre pagas. |
| create_transfer | Cria uma transferência entre duas contas bancárias (suporta recorrência). Prefira NOMES de conta (não invente ids). Não envolve cartões de crédito. |
| register_invoice_payment | Registra o pagamento de uma fatura de cartão MANUAL como lançamento, vinculado à fatura. Para cartões automáticos use inform_invoice_payment. Prefira NOMES de cartão/conta. |
| uninform_invoice_payment | Desfaz um "Informar Pagamento" em cartão AUTOMÁTICO (marcador aguardando Open Finance). Não remove pagamentos reais já confirmados. invoice_date_or_id é obrigatório. |
| create_category | Cria uma categoria de despesa ou receita (raiz ou subcategoria via parent_id). |
| update_category | Atualiza uma categoria (nome, cor, pai, arquivar). Categorias padrão não podem ser excluídas, mas podem ser renomeadas/arquivadas. Prefira NOME (não invente id). |
| delete_category | Exclui uma categoria; suas transações vão para outra categoria (substitute_category ou padrão). Categorias padrão NÃO podem ser excluídas. Ao excluir uma raiz, as subcategorias somem. |
| create_budget | Cria um limite de gastos (orçamento) para uma categoria. Padrão: despesa; use activity_type 'earning' para meta de receita. Prefira o NOME da categoria. |
| update_budget | Atualiza o valor de um orçamento existente. amount = 0 remove o orçamento. |
| delete_budget | Remove um orçamento (limite de gastos) de uma categoria. |
| clone_budgets | Clona os orçamentos do mês anterior para o mês de destino (não sobrescreve um mês que já tenha orçamentos). Padrão: mês atual. |
| update_account | Atualiza uma conta (nome, descrição, instituição, arquivar). Contas automáticas só permitem nome e archived. Prefira NOME (não invente id). |
| delete_account | Exclui uma conta. ATENÇÃO: todas as transações da conta são excluídas em background. Contas automáticas não podem ser excluídas (desconecte pelo menu de conexões). |
| create_credit_card | Cria um cartão de crédito MANUAL (automáticos vêm da conexão bancária). As faturas são geradas automaticamente após a criação. |
| update_credit_card | Atualiza um cartão de crédito (nome, bandeira, dias de fatura, limite, arquivar). Cartões automáticos só permitem nome e archived. Prefira NOME (não invente id). |
| delete_credit_card | Exclui um cartão de crédito. ATENÇÃO: todas as transações e faturas do cartão são excluídas. Cartões automáticos não podem ser excluídos (desconecte pelo menu de conexões). |
| mass_create_transactions | Cria VÁRIAS transações em lote (máx. 100) a partir de uma lista de objetos. Use em vez de create_transaction repetido. Executa em uma única chamada (sem confirmação interativa no MCP). |
| mass_update_transactions | Atualiza VÁRIAS transações por FILTRO de busca (máx. 200). Informe ao menos um filtro e ao menos um campo a alterar (categoria, descrição, observação, tags, pago). Use update_transaction para uma única. Ação em massa — irreversível em lote. |
| mass_delete_transactions | Exclui VÁRIAS transações por lista de ids/uuids (máx. 500). Os ids DEVEM vir de uma busca recente (list/search/find_duplicates/get_transaction) — nunca invente. Automáticas são ignoradas; recorrentes excluem só a ocorrência atual. Destrutivo. |
| add_transactions_tags | Adiciona tags a VÁRIAS transações em uma chamada (acumula sobre as existentes; máx. 200). Cada item: transaction_id ou transaction_uuid + tags (string com vírgulas ou lista). |
| update_transactions_categories | Define a categoria de VÁRIAS transações em uma chamada, com destino por linha (máx. 200). Ideal após suggest_categories quando cada linha tem categoria diferente. |