# Conta Azul MCP Muse connector

From musedirectory.ai, the independent directory of Meta Muse connectors. Not affiliated with Meta.

## Conta Azul MCP

Manage sales, customers, invoices and accounting in Conta Azul ERP

- Record: https://musedirectory.ai/connector/conta-azul-mcp
- Category: Finance & Bills
- Developer: douglac
- Muse status: Extra setup. Not in Muse's Connectors list yet. Muse can still use it: its page gives you a request to paste into Muse.
- Health: Working, 388ms, checked 2026-09-28T07:46:09Z
- Endpoint: https://api.mcp.ai/contaazul
- Auth: No account needed; Pricing: unknown
- Screening: Screened, no issues found (2026-09-25T07:02:02Z)
- Source: Found in the official MCP Registry (io.github.douglac/contaazul-mcp) https://registry.modelcontextprotocol.io/v0/servers?search=io.github.douglac%2Fcontaazul-mcp

Connects to Conta Azul, a Brazilian ERP system for small business. Muse can read and write sales, customers, products, services, receivables, payables, invoices (NF-e and NFS-e), and financial accounts. Requires OAuth login to your Conta Azul account.

Example request: "Show me all unpaid invoices due this month and record a payment I just received"

How to connect: Not in Muse's Connectors list yet, but Muse can still use it. Paste this into Muse: "Use Conta Azul MCP to help me. It is a free service with an MCP server at https://api.mcp.ai/contaazul. It does not need an API key. Ask me before you share anything with it." Muse asks before it shares anything with the app's site. Meta does not review apps used this way, so only use ones you trust. We tested this in the Muse app on September 24, 2026: Muse used an app's link directly this way and returned a live answer.

Tools:
- contaazul_list_accounts: Lista as empresas Conta Azul vinculadas a este install (company_id, label).
- contaazul_get_company: Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário).
- contaazul_list_people: Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo_perfil, ativo.
- contaazul_get_person: Detalhe de uma pessoa por id. Bulk support: accepts ids for batched execution.
- contaazul_person_write_create: Cria ou atualiza uma pessoa. action=create: requer nome, tipo_pessoa e (cpf|cnpj) — passe os campos via `data` (JSON). action=update: requer id e APENAS os campos a alterar em `data` (JSON) — é update PARCIAL: o resto do cadastro fica intacto e campo que o registro não tem NÃO é 
- contaazul_person_write_update: Cria ou atualiza uma pessoa. action=create: requer nome, tipo_pessoa e (cpf|cnpj) — passe os campos via `data` (JSON). action=update: requer id e APENAS os campos a alterar em `data` (JSON) — é update PARCIAL: o resto do cadastro fica intacto e campo que o registro não tem NÃO é 
- contaazul_person_delete: Remove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
- contaazul_list_products: Lista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo.
- contaazul_product_write: Cria um produto (nome + valor_venda obrigatórios em `data` JSON). A API v2 do Conta Azul não expõe atualização nem GET de produto por id — para consultar, use contaazul_list_products (/produto/busca) com filtro.
- contaazul_list_services: Lista serviços cadastrados.
- contaazul_service_write: Cria um serviço. `data` é JSON com nome, valor, etc.
- contaazul_list_sales: Lista vendas. Filtros: tamanho_pagina, pagina, data_inicio, data_fim (YYYY-MM-DD), cliente_id, status_venda. Bulk support: accepts cliente_ids for batched execution.
- contaazul_get_sale: Detalhe de uma venda por id. Bulk support: accepts ids for batched execution.
- contaazul_sale_write_create: Cria ou atualiza venda. action=create posta em /venda; action=update em /vendas/{id}. `data` é o payload completo da venda em JSON. [Flattened action: create] Bulk support: accepts ids for batched execution.
- contaazul_sale_write_update: Cria ou atualiza venda. action=create posta em /venda; action=update em /vendas/{id}. `data` é o payload completo da venda em JSON. [Flattened action: update] Bulk support: accepts ids for batched execution.
- contaazul_sale_cancel: Cancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.
- contaazul_list_contracts: Lista contratos no intervalo de data de início (data_inicio/data_fim, YYYY-MM-DD — obrigatórios na API; se omitidos, usa janela ampla = listar todos). Filtros: pagina, tamanho_pagina (máx 50), cliente_id, busca_textual. A API v2 não tem GET contrato por id nem cancelar/excluir. B
- contaazul_contract_write: Cria um contrato. `data` é o payload em JSON.
- contaazul_list_receivables: Lista contas a receber (parcelas de receita). Filtros: tamanho_pagina, pagina, data_vencimento_de, data_vencimento_ate (YYYY-MM-DD; se omitidas, lista todas), status (PERDIDO, RECEBIDO, EM_ABERTO, RENEGOCIADO, RECEBIDO_PARCIAL, ATRASADO), ids_clientes (UUID do cliente).
- contaazul_receivable_create: Cria um evento financeiro de conta a receber. `data` é o JSON do EventoFinanceiroRequest. OBRIGATÓRIOS: data_competencia (YYYY-MM-DD), valor (number), observacao, descricao, contato (UUID do cliente — via contaazul_list_people), conta_financeira (UUID — via contaazul_list_financi
- contaazul_list_payables: Lista contas a pagar (parcelas de despesa). Filtros: tamanho_pagina, pagina, data_vencimento_de, data_vencimento_ate (YYYY-MM-DD; se omitidas, lista todas), status (PERDIDO, RECEBIDO, EM_ABERTO, RENEGOCIADO, RECEBIDO_PARCIAL, ATRASADO).
- contaazul_payable_create: Cria um evento financeiro de conta a pagar. `data` é o JSON do EventoFinanceiroRequest (mesma estrutura do contaazul_receivable_create: data_competencia, valor, observacao, descricao, contato (UUID do fornecedor), conta_financeira (UUID), condicao_pagamento.parcelas[] (cada parce
- contaazul_list_installments: Lista as parcelas de UM evento financeiro (passe `id_evento`). A API v2 não tem listagem chapada de todas as parcelas — pra varrer contas a receber/pagar use contaazul_list_receivables / contaazul_list_payables.
- contaazul_get_installment: Detalhe de uma parcela por id. Bulk support: accepts ids for batched execution.
- contaazul_update_installment: Atualiza campos de uma parcela (PATCH). Campos editáveis em `data` JSON: nota, descricao, vencimento (YYYY-MM-DD), composicao_valor:{valor_bruto,multa,juros,desconto,taxa,valor_liquido}, data_pagamento_esperado, metodo_pagamento, perda, nsu, pagamento_agendado, id_conta_financeir
- contaazul_list_financial_accounts: Lista contas financeiras (banco, caixa, cartão). Filtre por `tipos`: APLICACAO, CAIXINHA, CONTA_CORRENTE, CARTAO_CREDITO, INVESTIMENTO, OUTROS, MEIOS_RECEBIMENTO, POUPANCA, COBRANCAS_CONTA_AZUL, RECEBA_FACIL_CARTAO. Para achar a conta que recebe cobranças (contaazul_generate_char
- contaazul_get_account_balance: Saldo atual de uma conta financeira por id (banco/caixa/cartão). Pegue o id em contaazul_list_financial_accounts. Bulk support: accepts ids for batched execution.
- contaazul_list_categories: Lista categorias financeiras (DRE).
- contaazul_list_cost_centers: Lista centros de custo.
- contaazul_list_invoices_nfe: Lista notas fiscais emitidas (NF-e). Filtros: tamanho_pagina, pagina, data_emissao_inicio, data_emissao_fim, status.
- contaazul_get_invoice_nfe: Detalhe de uma NF-e por id. Bulk support: accepts ids for batched execution.
- contaazul_list_invoices_nfse: Lista NFS-e (notas fiscais de serviço) por filtro. Exige data_competencia_de e data_competencia_ate (YYYY-MM-DD), com janela máxima de 15 dias (se omitidas, usa os últimos 15 dias). Outros filtros: id_cliente, numero_venda, status (PENDENTE, PRONTA_ENVIO, EMITIDA, CANCELADA…), ti
- contaazul_settle_installment: Registra a baixa (recebimento/pagamento) de uma parcela. `id` é o UUID da PARCELA (via contaazul_list_receivables / _list_payables / _get_installment). `data` é o JSON da baixa: data_pagamento (YYYY-MM-DD), composicao_valor {valor_bruto, multa, juros, desconto, taxa, valor_liquid
- contaazul_list_settlements: Lista as baixas de uma parcela. `id` é o UUID da parcela. Bulk support: accepts ids for batched execution.
- contaazul_get_settlement: Detalhe de uma baixa por id. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.
- contaazul_update_settlement: Atualiza uma baixa (PATCH). `id` é o UUID da baixa. `data` é o JSON com os campos a alterar (data_pagamento, composicao_valor, conta_financeira em UUID string, metodo_pagamento com o mesmo enum de contaazul_settle_installment, observacao). O campo `versao` é buscado automaticamen
- contaazul_delete_settlement: Estorna (remove) uma baixa por id. Operação destrutiva, confirme antes. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.
- contaazul_list_transfers: Lista transferências entre contas financeiras por período (conciliação). data_inicio e data_fim (YYYY-MM-DD) com janela máxima de 1 ano (se omitidas, usa os últimos 365 dias). Paginado.
- contaazul_get_initial_balance: Saldos iniciais das contas financeiras por período. data_inicio e data_fim (YYYY-MM-DD ou ISO date-time; datas simples são normalizadas). Se omitidas, usa uma janela ampla.
- contaazul_list_changed_events: Lista os IDs de eventos financeiros alterados num período (para sync incremental / conciliação). data_inicio e data_fim (YYYY-MM-DD ou ISO date-time). Paginado. Retorna só os IDs; use contaazul_get_installment para o detalhe.

Screening checks:
- MCP handshake: pass (Answered in 1363ms)
- Domain against threat feeds (Cloudflare security DNS): pass (api.mcp.ai not flagged)
- Published packages against the OSV malicious-package database: n/a (No npm or PyPI package published)
- Hidden instructions or invisible characters in tool text: pass (57 tools read, nothing found)
- Inputs asking for passwords, card numbers or seed phrases: pass (None found)
- Domain and redirects: pass (No redirects off the domain)
- AI review of purpose and tool behavior: pass (No concerns)