# Conta Azul MCP

Connects Brazilian ERP Conta Azul to AI assistants to query and update sales, invoices, and financial records over HTTP.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: douglac
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/douglac/contaazul-mcp
- Updated: 2026-10-05
- HTML: https://affpapa.org/en/nevibecode/mcp/conta-azul-mcp

## What it does

This tool connects an assistant to the Brazilian ERP Conta Azul through its v2 API. It exposes 52 tools for reading and writing data, covering customer profiles, contracts, payables, receivables, and NF-e electronic documents. The model can inspect account records and register new sales entries upon request.

The server runs remotely. Everything operates over HTTP at `https://api.mcp.ai/contaazul`, eliminating local runtime setups with Node.js. Authentication relies on helper tools `authenticate` and `connect`, which route the user through a web OAuth 2.0 flow.

Without remote HTTP transport support in your client, the connection will fail.

## Requirements
- Remote server: `https://api.mcp.ai/contaazul`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http contaazul-mcp https://api.mcp.ai/contaazul
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add conta-azul-mcp --url https://api.mcp.ai/contaazul
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "conta-azul-mcp": {
            "url": "https://api.mcp.ai/contaazul"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "conta-azul-mcp": {
            "type": "http",
            "url": "https://api.mcp.ai/contaazul"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http conta-azul-mcp https://api.mcp.ai/contaazul
```

## When to use it
- monitor overdue payables and incoming receivables
- verify status updates for NF-e invoices
- register new customer profiles in the ERP
- log settlement entries for pending installments

## Example prompts
- Show me all overdue receivables for this month in Conta Azul
- Check the processing state of the latest NF-e document
- Add a new vendor record to the ERP system

## Similar
- [mcp-conta-azul](https://affpapa.org/en/nevibecode/mcp/mcp-conta-azul.md) — MCP server · ★ 274
- [journal-entry](https://affpapa.org/en/nevibecode/skills/journal-entry.md) — skill · 2800 installs
- [mcp-omie](https://affpapa.org/en/nevibecode/mcp/mcp-omie.md) — MCP server · ★ 274
- [d365-solution-blueprint](https://affpapa.org/en/nevibecode/skills/d365-solution-blueprint.md) — skill · 13 installs
- [MCP Fiscal Brasil](https://affpapa.org/en/nevibecode/mcp/mcp-fiscal-brasil.md) — MCP server · ★ 375
- [fiscal](https://affpapa.org/en/nevibecode/mcp/fiscal.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md