Conta Azul MCP

douglac/contaazul-mcp

Connects Claude to Conta Azul, the Brazilian ERP platform, using OAuth 2.0 for authentication. You get 35 tools covering the full API v2 surface: customers, suppliers, products, sales, contracts, accounts payable and receivable, installment payments, and NF-e tax invoices. Both read and write operations are supported, so you can query overdue receivables, create new customer records, register sales, or mark invoices as paid, all in natural language. Runs as a remote HTTP server at api.mcp.ai/contaazul with one-click setup for Claude Desktop, Cursor, and VS Code. The OAuth flow handles company authorization directly through Conta Azul's interface, no manual token management required. Useful if you're managing Brazilian business financials and want conversational access to your ERP data.

GitHub stars: 6
tools: 57
transport: HTTP
last updated: May 29, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://api.mcp.ai/contaazul --name contaazul-mcp

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http contaazul-mcp https://api.mcp.ai/contaazul

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 57 tools

Verified live against the running server on Nov 6, 2026.

contaazul_list_accountsLista as empresas Conta Azul vinculadas a este install (company_id, label).1 params

Lista as empresas Conta Azul vinculadas a este install (company_id, label).

Parameters* required

accountstring

contaazul_get_companyDados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário).1 params

Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário).

Parameters* required

accountstring

contaazul_list_peopleLista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo_perfil, ativo.6 params

Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo_perfil, ativo.

Parameters* required

accountstring

ativoboolean

buscastring

paginanumber

tamanho_paginanumber

tipo_perfilstring

contaazul_get_personDetalhe de uma pessoa por id. Bulk support: accepts ids for batched execution.3 params

Detalhe de uma pessoa por id. Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_person_write_createCria 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...4 params

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...

Parameters* required

accountstring

data*string

idstring

idsarray

contaazul_person_write_updateCria 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...4 params

Parameters* required

accountstring

data*string

idstring

idsarray

contaazul_person_deleteRemove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.3 params

Remove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_list_productsLista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo.5 params

Lista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo.

Parameters* required

accountstring

ativoboolean

buscastring

paginanumber

tamanho_paginanumber

contaazul_product_writeCria 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.2 params

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.

Parameters* required

accountstring

data*string

contaazul_list_servicesLista serviços cadastrados.4 params

Lista serviços cadastrados.

Parameters* required

accountstring

buscastring

paginanumber

tamanho_paginanumber

contaazul_service_writeCria um serviço. `data` é JSON com nome, valor, etc.2 params

Cria um serviço. `data` é JSON com nome, valor, etc.

Parameters* required

accountstring

data*string

contaazul_list_salesLista vendas (GET /venda/busca). Filtros: data_inicio/data_fim (emissão, AAAA-MM-DD), data_criacao_de/ate (AAAA-MM-DD), data_alteracao_de/ate (AAAA-MM-DDTHH:MM:SS), ids_clientes, ids_vendedores, ids_categorias, ids_produtos, numeros, situacoes (enum de BUSCA: in_process, appro...24 params

Lista vendas (GET /venda/busca). Filtros: data_inicio/data_fim (emissão, AAAA-MM-DD), data_criacao_de/ate (AAAA-MM-DD), data_alteracao_de/ate (AAAA-MM-DDTHH:MM:SS), ids_clientes, ids_vendedores, ids_categorias, ids_produtos, numeros, situacoes (enum de BUSCA: in_process, appro...

Parameters* required

accountstring

campo_ordenado_ascendentestring

one of numero · cliente · data

campo_ordenado_descendentestring

one of numero · cliente · data

cliente_idstring

cliente_idsarray

data_alteracao_atestring

data_alteracao_destring

data_criacao_atestring

data_criacao_destring

data_fimstring

data_iniciostring

ids_categoriasarray

ids_clientesarray

ids_produtosarray

ids_vendedoresarray

numerosarray

origensarray

paginanumber

situacoesarray

status_vendastring

+4 more parameters. See the server's own documentation for the full schema.

contaazul_list_sale_itemsItens (produtos/serviços, quantidade, valor) de uma ou mais vendas. Passe ids_venda (até 50); devolve um resultado por venda.4 params

Itens (produtos/serviços, quantidade, valor) de uma ou mais vendas. Passe ids_venda (até 50); devolve um resultado por venda.

Parameters* required

accountstring

ids_venda*array

paginanumber

tamanho_paginanumber

contaazul_get_saleDetalhe de uma venda por id. Bulk support: accepts ids for batched execution.3 params

Detalhe de uma venda por id. Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_sale_write_createCria ou atualiza venda. `data` é o payload da venda em JSON. action=create (POST /venda) — OBRIGATÓRIOS: id_cliente (UUID, via contaazul_list_people), situacao (EM_ANDAMENTO ou APROVADO), data_venda (AAAA-MM-DD), itens[] e condicao_pagamento; `numero` é obrigatório na API mas,...4 params

Cria ou atualiza venda. `data` é o payload da venda em JSON. action=create (POST /venda) — OBRIGATÓRIOS: id_cliente (UUID, via contaazul_list_people), situacao (EM_ANDAMENTO ou APROVADO), data_venda (AAAA-MM-DD), itens[] e condicao_pagamento; `numero` é obrigatório na API mas,...

Parameters* required

accountstring

data*string

idstring

idsarray

contaazul_sale_write_updateCria ou atualiza venda. `data` é o payload da venda em JSON. action=create (POST /venda) — OBRIGATÓRIOS: id_cliente (UUID, via contaazul_list_people), situacao (EM_ANDAMENTO ou APROVADO), data_venda (AAAA-MM-DD), itens[] e condicao_pagamento; `numero` é obrigatório na API mas,...4 params

Parameters* required

accountstring

data*string

idstring

idsarray

contaazul_sale_cancelCancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.3 params

Cancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_list_contractsLista 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...8 params

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...

Parameters* required

accountstring

busca_textualstring

cliente_idstring

cliente_idsarray

data_fimstring

data_iniciostring

paginanumber

tamanho_paginanumber

contaazul_contract_writeCria um contrato. `data` é o payload em JSON.2 params

Cria um contrato. `data` é o payload em JSON.

Parameters* required

accountstring

data*string

contaazul_list_receivablesLista 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).7 params

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).

Parameters* required

accountstring

data_vencimento_atestring

data_vencimento_destring

ids_clientesstring

paginanumber

statusstring

tamanho_paginanumber

contaazul_receivable_createCria um evento financeiro de conta a receber. `data` é o JSON do EventoFinanceiroRequest. OBRIGATÓRIOS (a chamada é recusada antes de ir à API se faltar algum): id_cliente (UUID do cliente, via contaazul_list_people; `contato` é aceito como alias), conta_financeira (UUID, via...2 params

Cria um evento financeiro de conta a receber. `data` é o JSON do EventoFinanceiroRequest. OBRIGATÓRIOS (a chamada é recusada antes de ir à API se faltar algum): id_cliente (UUID do cliente, via contaazul_list_people; `contato` é aceito como alias), conta_financeira (UUID, via...

Parameters* required

accountstring

data*string

contaazul_list_payablesLista 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). O Conta Azul usa os MESMOS status de con...6 params

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). O Conta Azul usa os MESMOS status de con...

Parameters* required

accountstring

data_vencimento_atestring

data_vencimento_destring

paginanumber

statusstring

tamanho_paginanumber

contaazul_payable_createCria um evento financeiro de conta a pagar. `data` é o JSON do EventoFinanceiroRequest. OBRIGATÓRIOS (a chamada é recusada antes de ir à API se faltar algum): id_fornecedor (UUID do fornecedor, via contaazul_list_people; `contato` é aceito como alias), conta_financeira (UUID,...2 params

Cria um evento financeiro de conta a pagar. `data` é o JSON do EventoFinanceiroRequest. OBRIGATÓRIOS (a chamada é recusada antes de ir à API se faltar algum): id_fornecedor (UUID do fornecedor, via contaazul_list_people; `contato` é aceito como alias), conta_financeira (UUID,...

Parameters* required

accountstring

data*string

contaazul_list_installmentsLista 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.2 params

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.

Parameters* required

accountstring

id_evento*string

contaazul_get_installmentDetalhe de uma parcela por id. Bulk support: accepts ids for batched execution.3 params

Detalhe de uma parcela por id. Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_update_installmentAtualiza 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_financ...4 params

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_financ...

Parameters* required

accountstring

data*string

id*string

idsarray

contaazul_list_financial_accountsLista 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_c...6 params

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_c...

Parameters* required

accountstring

apenas_ativoboolean

nomestring

paginanumber

tamanho_paginanumber

tiposarray

contaazul_get_account_balanceSaldo 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.3 params

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.

Parameters* required

accountstring

id*string

idsarray

contaazul_list_categoriesLista categorias financeiras (DRE).4 params

Lista categorias financeiras (DRE).

Parameters* required

accountstring

paginanumber

tamanho_paginanumber

tipostring

contaazul_list_cost_centersLista centros de custo.3 params

Lista centros de custo.

Parameters* required

accountstring

paginanumber

tamanho_paginanumber

contaazul_list_invoices_nfeLista NF-e (notas fiscais de produto) EMITIDAS ou CORRIGIDAS COM SUCESSO (a API não filtra por status). data_inicial e data_final (AAAA-MM-DD) são OBRIGATÓRIAS na API e a janela máxima dela é de 15 dias: se omitidas, usamos os últimos 15 dias; se vier só uma, a outra fica a 15...10 params

Lista NF-e (notas fiscais de produto) EMITIDAS ou CORRIGIDAS COM SUCESSO (a API não filtra por status). data_inicial e data_final (AAAA-MM-DD) são OBRIGATÓRIAS na API e a janela máxima dela é de 15 dias: se omitidas, usamos os últimos 15 dias; se vier só uma, a outra fica a 15...

Parameters* required

accountstring

data_emissao_fimstring

data_emissao_iniciostring

data_finalstring

data_inicialstring

documento_tomadorstring

id_vendastring

numero_notastring

paginanumber

tamanho_paginanumber

contaazul_get_invoice_nfeDetalhe de uma NF-e por id. Bulk support: accepts ids for batched execution.3 params

Detalhe de uma NF-e por id. Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_list_invoices_nfseLista 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; se vier só uma, a outra fica a 15 dias de distância). Outros filtros: id_cliente, numero_venda,...13 params

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; se vier só uma, a outra fica a 15 dias de distância). Outros filtros: id_cliente, numero_venda,...

Parameters* required

accountstring

data_competencia_atestring

data_competencia_destring

id_clientestring

numero_nfse_finalnumber

numero_nfse_inicialnumber

numero_rps_finalnumber

numero_rps_inicialnumber

numero_vendastring

paginanumber

statusstring

tamanho_paginanumber

tipo_negociacaostring

contaazul_settle_installmentRegistra 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_liq...4 params

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_liq...

Parameters* required

accountstring

data*string

id*string

idsarray

contaazul_list_settlementsLista as baixas de uma parcela. `id` é o UUID da parcela. Bulk support: accepts ids for batched execution.3 params

Lista as baixas de uma parcela. `id` é o UUID da parcela. Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_get_settlementDetalhe de uma baixa por id. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.3 params

Detalhe de uma baixa por id. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_update_settlementAtualiza 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 automatica...4 params

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 automatica...

Parameters* required

accountstring

data*string

id*string

idsarray

contaazul_delete_settlementEstorna (remove) uma baixa por id. Operação destrutiva, confirme antes. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.3 params

Estorna (remove) uma baixa por id. Operação destrutiva, confirme antes. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_list_transfersLista 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.5 params

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.

Parameters* required

accountstring

data_fimstring

data_iniciostring

paginanumber

tamanho_paginanumber

contaazul_get_initial_balanceSaldos 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.3 params

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.

Parameters* required

accountstring

data_fimstring

data_iniciostring

contaazul_list_changed_eventsLista 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.5 params

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.

Parameters* required

accountstring

data_fimstring

data_iniciostring

paginanumber

tamanho_paginanumber

contaazul_generate_chargeGera cobrança (boleto, pix ou link de pagamento) para uma ou mais PARCELAS de contas a receber. Aceita até 50 parcelas por chamada; cada uma é emitida separadamente e uma falha não aborta o lote. `tipo` (obrigatório) aceita EXATAMENTE: BOLETO, PIX_COBRANCA ou LINK_PAGAMENTO (c...11 params

Gera cobrança (boleto, pix ou link de pagamento) para uma ou mais PARCELAS de contas a receber. Aceita até 50 parcelas por chamada; cada uma é emitida separadamente e uma falha não aborta o lote. `tipo` (obrigatório) aceita EXATAMENTE: BOLETO, PIX_COBRANCA ou LINK_PAGAMENTO (c...

Parameters* required

accountstring

conta_bancariastring

datastring

data_vencimentostring

desconto_antecipadoobject

descricao_faturastring

forcarboolean

id_parcelastring

ids_parcelasarray

maximo_parcelasnumber

tipo*string

contaazul_get_chargeDetalhe de uma cobrança emitida por id (o `id` devolvido em contaazul_generate_charge). Retorna {id, url, status} — status vai de AGUARDANDO_CONFIRMACAO/REGISTRADO até PAGO, CANCELADO, EXPIRADO ou FALHA_EMISSAO. Bulk support: accepts ids for batched execution.3 params

Detalhe de uma cobrança emitida por id (o `id` devolvido em contaazul_generate_charge). Retorna {id, url, status} — status vai de AGUARDANDO_CONFIRMACAO/REGISTRADO até PAGO, CANCELADO, EXPIRADO ou FALHA_EMISSAO. Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_cancel_chargeCANCELA uma cobrança já emitida (boleto/pix/link deixa de ser pagável). Use quando a cobrança foi gerada errada e ainda não foi paga. Passe o `id` da cobrança (de contaazul_generate_charge ou contaazul_get_charge), NÃO o id da parcela. Bulk support: accepts ids for batched exe...3 params

CANCELA uma cobrança já emitida (boleto/pix/link deixa de ser pagável). Use quando a cobrança foi gerada errada e ainda não foi paga. Passe o `id` da cobrança (de contaazul_generate_charge ou contaazul_get_charge), NÃO o id da parcela. Bulk support: accepts ids for batched exe...

Parameters* required

accountstring

id*string

idsarray

contaazul_get_contractDetalhe de um contrato por id (cliente, termos, condição de pagamento, composição de valor). Bulk support: accepts ids for batched execution.3 params

Detalhe de um contrato por id (cliente, termos, condição de pagamento, composição de valor). Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_contract_next_numberRetorna o próximo número de contrato disponível.1 params

Retorna o próximo número de contrato disponível.

Parameters* required

accountstring

contaazul_terminate_contractEncerra um contrato por id. Operação sensível, confirme antes. Bulk support: accepts ids for batched execution.3 params

Encerra um contrato por id. Operação sensível, confirme antes. Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_delete_contractRemove um contrato por id. Operação destrutiva, confirme antes. Bulk support: accepts ids for batched execution.3 params

Remove um contrato por id. Operação destrutiva, confirme antes. Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_list_budgetsLista orçamentos (cliente, número, total, situação, versão). Paginado.3 params

Lista orçamentos (cliente, número, total, situação, versão). Paginado.

Parameters* required

accountstring

paginanumber

tamanho_paginanumber

contaazul_get_budgetDetalhe de um orçamento por id (itens, cliente, composição de valor). Bulk support: accepts ids for batched execution.3 params

Detalhe de um orçamento por id (itens, cliente, composição de valor). Bulk support: accepts ids for batched execution.

Parameters* required

accountstring

id*string

idsarray

contaazul_create_budgetCria um orçamento. `data` é o JSON com id_cliente (obrigatório, UUID de uma pessoa com perfil Cliente), data_orcamento (obrigatório, YYYY-MM-DD), itens[] (cada item exige id do produto/serviço + tipo/quantidade/valor), data_validade, id_vendedor e composicao_de_valor (frete, d...2 params

Cria um orçamento. `data` é o JSON com id_cliente (obrigatório, UUID de uma pessoa com perfil Cliente), data_orcamento (obrigatório, YYYY-MM-DD), itens[] (cada item exige id do produto/serviço + tipo/quantidade/valor), data_validade, id_vendedor e composicao_de_valor (frete, d...

Parameters* required

accountstring

data*string

contaazul_delete_budgetsExclui orçamentos em lote por id. Operação destrutiva, confirme antes. `ids` é a lista de UUIDs de orçamento (a API v2 não tem exclusão por id única).2 params

Exclui orçamentos em lote por id. Operação destrutiva, confirme antes. `ids` é a lista de UUIDs de orçamento (a API v2 não tem exclusão por id única).

Parameters* required

accountstring

ids*array

show_versionShow the current MCP platform and adapter versions.

Show the current MCP platform and adapter versions.

No parameters. Call it with no arguments.

report_bugReport a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.3 params

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Parameters* required

contextstring

default:

conversationstring

default: []

message*string

connectReturns 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.

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.

No parameters. Call it with no arguments.

toolkit_infoReturns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

No parameters. Call it with no arguments.

marketplaceThe 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...23 params

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...

Parameters* required

actionstring

one of search · describe · install · uninstall · subscribe · canceldefault: search

argumentsstring

default: {}

cancel_commentstring

default:

cancel_reasonstring

one of too_expensive · missing_features · switched_service · unused · customer_service · too_complex

conversationstring

default: []

immediateboolean

default: false

limitnumber

default: 10

mcp_idstring

default:

messagestring

default:

prompt_bodystring

default:

prompt_categorystring

default:

prompt_descriptionstring

default:

prompt_slugstring

default:

prompt_targetsarray

prompt_titlestring

default:

prompt_toolstring

default:

prompt_varsstring

default: {}

querystring

default:

report_contextstring

default:

request_detailsstring

default:

+3 more parameters. See the server's own documentation for the full schema.

Readme

Conta Azul MCP

ERP financeiro Conta Azul para Claude, Cursor e agentes de IA

Conecte sua conta Conta Azul ao seu agente de IA. Gerencie clientes e fornecedores, produtos, serviços, vendas, contratos, contas a pagar e receber, parcelas, quitações e NF-e em linguagem natural. Login via OAuth da própria Conta Azul, em 30 segundos — sem digitar token, sem configurar nada.

🏢 ERP completo — pessoas, produtos, vendas, contratos, financeiro e NF-e em um só lugar
💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
✍️ Lê e escreve — a IA consulta dados e também cria/edita cadastros, vendas, contas e quitações (sempre quando você pede)
📊 52 ferramentas cobrindo a API v2 da Conta Azul
🔑 OAuth 2.0 da Conta Azul — a plataforma fornece a aplicação OAuth, você só clica em Autorizar
🛡️ LGPD-compliant — consentimento explícito, retenção mínima, você no controle

English version · Documentação completa · Skills do Claude Code

Instalar em 1 clique

Claude (Web e Desktop)

View the full README on GitHub

Details

Repository: github.com/douglac/contaazul-mcp
Category: Sales & Marketing
Transport: HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Sales & Marketing MCP servers

View all

Companyscope Mcpstewyboy1990/companyscope-mcp11 company intelligence tools — financials, tech stack, competitors, patents, jobs, news. Free.4stars

Easy Digital Downloadsverygoodplugins/mcp-eddMCP server for Easy Digital Downloads REST API - sales, customers, products, analytics4stars

Icp Intelligence Mcpshashwatgtm/icp-intelligence-mcpICP Intelligence: 9 ideal customer profile tools by Helix GTM Consulting3stars

Mcp Facturacion Electronica Escmendezs/mcp-facturacion-electronica-esSpanish e-invoicing MCP server: VERI*FACTU, Facturae/FACe, SII, Crea y Crece B2B.2stars

Spain Legal by Legal Fournierheyalerio/legalfournier-spain-legal-mcpSpain legal screening, articles, videos, interactive apps, public skills, and consent-based contact.2stars

Pickanagencynatden444/pickanagency-mcpSearch 47,000+ marketing agencies and get AI-matched with fitted agencies, from Pick an Agency.2stars

Conta Azul MCP

Install

Tools

Readme

Conta Azul MCP

ERP financeiro Conta Azul para Claude, Cursor e agentes de IA

Instalar em 1 clique

Claude (Web e Desktop)

Details

More from douglac

Related Sales & Marketing MCP servers