# Organizze — MCP server on mcp.ai
> Your Organizze finances in natural language: consolidated balances, monthly overview, transaction search, credit card invoices, recurring bills, budgets, reports by category and tag, cash flow forecast and Open Finance status. Connect your account in one click, no key or token. On the Organizze screen, uncheck "Permitir alterações" if you want read-only access.

By: mcp.ai · official
Page: https://mcp.ai/organizze

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_organizze?ms=1788507600000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/organizze/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/organizze/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/organizze/skill.md
Postman collection (v2.1): https://mcp.ai/organizze/postman.json

## Tools
- organizze_add_transactions_tags(items: object[]) — 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_clone_budgets(month?: integer, year?: integer) — 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_create_account(name: string, institution_id?: string, initial_balance?: number, description?: string) — Cria uma conta bancária manual.
- organizze_create_budget(category: string, amount: number, activity_type?: string, month?: integer, year?: integer) — 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_create_category(name: string, kind: string, group_id?: string, color?: string, parent_id?: integer) — Cria uma categoria de despesa ou receita (raiz ou subcategoria via parent_id).
- organizze_create_credit_card(name: string, billing_due_day: integer, billing_cycle_day: integer, flag?: string, limit?: number, payment_account_id?: integer) — 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.
- organizze_create_transaction(description: string, amount: number, date: string, account: string, category?: string, is_income: boolean, done?: boolean, observation?: string, tags?: string, times?: integer, recurring?: boolean, periodicity?: string, idempotency_key?: string) — 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: "N
- organizze_create_transfer(amount: number, date: string, credit_account: string, debit_account: string, description?: string, done?: boolean, observation?: string, tags?: string, recurring?: boolean, periodicity?: string) — 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_delete_account(account: string) — 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_delete_budget(budget_id: integer) — Remove um orçamento (limite de gastos) de uma categoria.
- organizze_delete_category(category: string, substitute_category?: string) — 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_delete_credit_card(credit_card: string) — 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_delete_transaction(transaction_id?: integer, transaction_uuid?: string, delete_recurrence?: string) — 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_transac
- organizze_find_duplicates(start_date?: string, end_date?: string, days_threshold?: integer, include_automatic?: boolean) — 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(start_date?: string, end_date?: string, account?: string, min_occurrences?: integer) — 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 
- organizze_find_subscriptions(start_date?: string, end_date?: string, account?: string, min_occurrences?: integer, include_recurrences?: boolean) — 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 
- 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 cha
- 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 
- 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_budget_summary(month?: integer, year?: integer) — 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_cashflow_forecast(days?: integer, start_date?: string) — 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
- organizze_get_categories_evolution(start_date?: string, end_date?: string, periodicity?: string, category_ids?: integer[], only_parent_category?: boolean, lens?: string) — 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_categories_report(start_date?: string, end_date?: string, lens?: string) — 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_credit_card_invoice(credit_card?: string, credit_card_id?: integer, invoice_id?: integer, month?: integer, year?: integer) — 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.
- organizze_get_credit_card_invoices(credit_card_id: integer, start_date?: string, end_date?: string) — Lista faturas de um cartão. Informe credit_card_id.
- organizze_get_financial_summary(start_date?: string, end_date?: string, year?: integer, month?: integer) — 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_get_income_vs_expenses(start_date?: string, end_date?: string, periodicity?: string, account_id?: integer) — 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 car
- organizze_get_invoices_matrix(start_date?: string, end_date?: string, cards?: string[]) — 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
- organizze_get_latest_imports(limit?: integer, page?: integer, per_page?: integer) — 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_monthly_overview(month?: integer, year?: integer) — 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_e
- organizze_get_open_finance_status(institution?: string) — 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_tags_report(start_date?: string, end_date?: string, tag_name?: string, tag_name_prefix?: string) — 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_transaction(transaction_id?: integer, transaction_uuid?: string) — Detalhes completos de uma transação pelo id ou uuid.
- organizze_get_upcoming_bills(days?: integer, start_date?: string) — 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_inform_invoice_payment(credit_card: string, invoice_date_or_id?: string, date?: string, observation?: string) — Informa pagamento de fatura em cartão automático (Open Finance).
- organizze_list_accounts() — Lista as contas do usuário com ids.
- organizze_list_budgets(year?: integer, month?: integer) — Lista limites de gastos por categoria. Passe year e/ou month para escopo.
- organizze_list_categories() — Lista as categorias usadas para classificar transações.
- organizze_list_credit_cards() — Lista os cartões de crédito do usuário com ids e limites.
- organizze_list_institutions(query?: string, limit?: integer) — 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_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/ca
- organizze_list_transactions(start_date?: string, end_date?: string, account_id?: integer, credit_card_id?: integer, category_id?: integer, order_by?: string, list_mode?: string, page?: integer, per_page?: integer, installments_only?: boolean) — 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 co
- organizze_list_transferences(start_date?: string, end_date?: string, account_id?: integer, page?: integer, per_page?: integer) — Lista transferências entre contas com paginação (page/per_page). Datas em YYYY-MM-DD.
- organizze_load_skill(skill_name: string) — Carrega um guia detalhado de uso (skill) sobre um tema do Organizze. Chame ANTES de responder quando a conversa tocar um destes temas:
- organizze_mass_create_transactions(transactions: object[], idempotency_key?: string) — 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 paylo
- organizze_mass_delete_transactions(transactions: object[]) — 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 
- organizze_mass_manage_categories(operations: object[]) — 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
- organizze_mass_update_transactions(query?: string, start_date?: string, end_date?: string, category_id?: integer, account_id?: integer, credit_card_id?: integer, activity_type?: string, tag_filter?: string, paid_filter?: boolean, new_category?: string, new_description?: string, description_find?: string, description_replace?: string, new_observation?: string, new_tags?: string, tag_action?: string, new_paid?: boolean) — 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_transacti
- organizze_register_invoice_payment(credit_card: string, source_account?: string, amount: number, date: string, invoice_date_or_id?: string, observation?: string) — 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_credi
- organizze_resolve_entity(name: string, kind?: string) — 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_search_transactions(query: string, start_date?: string, end_date?: string, min_amount?: number, max_amount?: number, activity_type?: string, page?: integer, per_page?: integer, tags_only?: boolean) — 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_set_transaction_paid(paid: boolean, transaction_id?: integer, transaction_uuid?: string) — 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.
- organizze_suggest_categories(items: object[]) — 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 classific
- organizze_transactions_list_results(start_date?: string, end_date?: string, account_id?: integer, category_id?: integer, list_mode?: string) — 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
- organizze_uninform_invoice_payment(credit_card: string, invoice_date_or_id: string) — 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.
- organizze_update_account(account: string, name?: string, description?: string, institution_id?: string, archived?: boolean, hide_balance?: boolean) — Atualiza uma conta (nome, descrição, instituição, arquivar). Contas automáticas só permitem nome e archived. Prefira NOME (não invente id).
- organizze_update_budget(budget_id: integer, amount: number) — Atualiza o valor de um orçamento existente. amount = 0 remove o orçamento.
- organizze_update_category(category: string, name?: string, color?: string, parent?: string, archived?: boolean) — 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_update_credit_card(credit_card: string, name?: string, flag?: string, billing_due_day?: integer, billing_cycle_day?: integer, limit?: number, payment_account_id?: integer, archived?: boolean) — 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).
- organizze_update_transaction(transaction_id?: integer, transaction_uuid?: string, description?: string, amount?: number, date?: string, category?: string, account?: string, paid?: boolean, observation?: string, tags?: string, update_recurrence?: string) — 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).
- organizze_update_transactions_categories(updates: object[]) — 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 l
- organizze_update_transactions_descriptions(updates: object[]) — 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/se

## Example prompts
- "How was my month? Income, expenses and balance"
- "Which recurring subscriptions do I have?"
- "How much do I still have to pay this week?"

## Links
Docs: https://mcp.ai/docs/mcps/organizze
Website: https://mcp.ai/mcps/organizze