All servers · Shops & products · Payments & accounting

Organizze

io.github.mcp-dir/organizze-mcp · v0.1.0

Measured by MCP Station

Description written by the publisher, not verified

Your Organizze finances in natural language: consolidated balances, monthly overview, transaction se

Connect

claude mcp add --transport http organizze-mcp https://api.mcp.ai/p_organizze

{
  "mcpServers": {
    "organizze-mcp": {
      "url": "https://api.mcp.ai/p_organizze"
    }
  }
}

Tools as reported by the server

• organizze_list_accounts
  Lista as contas do usuário com ids.
• organizze_list_credit_cards
  Lista os cartões de crédito do usuário com ids e limites.
• organizze_list_categories
  Lista as categorias usadas para classificar transações.
• organizze_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 ga
• organizze_list_transferences
  Lista transferências entre contas com paginação (page/per_page). Datas em YYYY-MM-DD. Bulk support: accepts account_ids for batched execution.
• organizze_list_budgets
  Lista limites de gastos por categoria. Passe year e/ou month para escopo.
• organizze_get_credit_card_invoices
  Lista faturas de um cartão. Informe credit_card_id. Bulk support: accepts credit_card_ids for batched execution.
• organizze_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.
• organizze_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.
• organizze_get_transaction
  Detalhes completos de uma transação pelo id ou uuid. Bulk support: accepts transaction_ids for batched execution.
• organizze_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. Bulk support: accepts credit_card_ids, invoice_ids for batched execution.
• organizze_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.
• organizze_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). Bulk support: accepts account_ids for batched execution.
• organizze_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 ba
• organizze_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 aplica
• organizze_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_*.
• organizze_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.
• organizze_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.
• organizze_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.
• organizze_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.
• organizze_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.
• organizze_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.
• organizze_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.
• organizze_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.
• organizze_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.
• organizze_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 (
• organizze_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".
• organizze_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.
• organizze_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).
• organizze_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".
• organizze_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.
• organizze_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.
• organizze_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.
• organizze_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
• organizze_create_transaction
  Cria uma transação (receita ou despesa). Prefira NOMES de conta/cartão e categoria (list_accounts / list_credit_cards / list_categories primeiro se não souber). Nunca invente UUID/id. Ex.: account: "Nubank", category: "Alimentação", is_income: false.
• organizze_create_account
  Cria uma conta bancária manual. Bulk support: accepts institution_ids for batched execution.
• organizze_inform_invoice_payment
  Informa pagamento de fatura em cartão automático (Open Finance). Bulk support: accepts invoice_date_or_ids for batched execution.
• organizze_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). O transaction_id/uuid DEVE ser copiado de list_transactions, search_transactions ou get_transaction
• organizze_delete_transaction
  Exclui uma transação. Transações automáticas (Open Finance) não podem ser excluídas. Para recorrentes use delete_recurrence. O transaction_id/uuid DEVE ser copiado de list_transactions, search_transactions ou get_transaction nesta conexão — nunca invente nem sequencie IDs. Para várias linhas, use ma
• organizze_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. Bulk support: accepts transaction_ids for batched execution.
• organizze_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.
• organizze_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. Liste faturas com get_credit_card_invoices e passe invoice_date_or_id (id ou YYYY-MM) — nunca invente. Bulk support: accepts in
• organizze_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. Bulk support: accepts invoice_date_or_ids for batched execution.
• organizze_create_category
  Cria uma categoria de despesa ou receita (raiz ou subcategoria via parent_id). Bulk support: accepts group_ids, parent_ids for batched execution.
• organizze_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).
• organizze_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.
• organizze_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.
• organizze_update_budget
  Atualiza o valor de um orçamento existente. amount = 0 remove o orçamento. Bulk support: accepts budget_ids for batched execution.
• organizze_delete_budget
  Remove um orçamento (limite de gastos) de uma categoria. Bulk support: accepts budget_ids for batched execution.
• organizze_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.
• organizze_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). Bulk support: accepts institution_ids for batched execution.
• organizze_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).
• organizze_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. Bulk support: accepts payment_account_ids for batched execution.
• organizze_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). Bulk support: accepts payment_account_ids for batched execution.
• organizze_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).
• organizze_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. Cada linha no array deve ser única (descrição+valor+data+conta) — dedupe no payload antes de enviar. NÃO use para importar CSV/OFX com snapshot canônico — nesse caso o app redirecio
• organizze_mass_update_transactions
  Atualiza VÁRIAS transações por FILTRO de busca (máx. 200) — prefira isto a montar listas de IDs quando a mesma alteração vale para todas as linhas. Antes, valide com list_transactions/search_transactions os mesmos filtros. Informe ao menos um filtro e um campo a alterar. Prefira new_category por NOM
• organizze_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.
• organizze_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).
• organizze_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. Prefira category (NOME) e IDs só de list/suggest deste turno — nunca invente. Se a mesma categoria vale para todas, prefira mass_update_t
• organizze_update_transactions_descriptions
  Substitui a descrição de VÁRIAS transações em uma chamada (máx. 200). Cada item: transaction_id (ou id) OU transaction_uuid (ou uuid) + description (ou new_description). IDs só de list_transactions/search deste turno. Aceita um único objeto em vez de array. Se a mesma descrição/regra vale para todas
• organizze_mass_manage_categories
  Aplica VÁRIAS mudanças na árvore de categorias em uma chamada atômica (máx. 100 ops). Operações: create, rename, move (parent '0' = raiz), archive, unarchive (NÃO há delete — use archive). Resolve por NOME (não invente ids). Se uma falhar, nada é alterado.
• show_version
  Show the current MCP platform and adapter versions.
• report_bug
  Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
• connect
  Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.
• toolkit_info
  Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
• marketplace
  The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (ev
• authenticate
  MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes

Repository · JSON · Text for agents · Registry updated 2026-09-04