@codespar/mcp-conta-azul
v0.2.1
Published
MCP server for Conta Azul — accounting, invoicing, customers, products
Maintainers
Readme
@codespar/mcp-conta-azul
MCP server for Conta Azul — ERP, accounting, invoicing, and financial management
Quick Start
Claude Desktop
Add to ~/.config/claude/claude_desktop_config.json:
{
"mcpServers": {
"conta-azul": {
"command": "npx",
"args": ["-y", "@codespar/mcp-conta-azul"],
"env": {
"CONTA_AZUL_ACCESS_TOKEN": "your-token"
}
}
}
}Claude Code
claude mcp add conta-azul -- npx @codespar/mcp-conta-azulCursor / VS Code
Add to .cursor/mcp.json or .vscode/mcp.json:
{
"servers": {
"conta-azul": {
"command": "npx",
"args": ["-y", "@codespar/mcp-conta-azul"],
"env": {
"CONTA_AZUL_ACCESS_TOKEN": "your-token"
}
}
}
}Tools (20)
| Tool | Purpose |
|---|---|
| list_customers | List customers in Conta Azul |
| create_customer | Create a customer in Conta Azul |
| update_customer | Update a customer in Conta Azul |
| delete_customer | Delete a customer in Conta Azul |
| list_products | List products in Conta Azul |
| create_product | Create a product in Conta Azul |
| update_product | Update a product in Conta Azul |
| delete_product | Delete a product in Conta Azul |
| list_sales | List sales in Conta Azul |
| create_sale | Create a sale in Conta Azul |
| get_sale | Get a sale by id in Conta Azul |
| cancel_sale | Cancel a sale in Conta Azul |
| list_services | List services in Conta Azul |
| create_service | Create a service in Conta Azul |
| update_service | Update a service in Conta Azul |
| delete_service | Delete a service in Conta Azul |
| get_financial_summary | Get financial summary from Conta Azul |
| list_categories | List product/service categories |
| list_bank_accounts | List bank accounts in Conta Azul |
| list_accounts_receivable | List accounts receivable (financial events to receive) in Conta Azul |
Authentication
Conta Azul uses OAuth2 Bearer tokens for authentication.
Sandbox / Testing
Conta Azul provides a sandbox via the OAuth flow. Use sandbox credentials for testing.
Get your credentials
- Go to Conta Azul Developer Portal
- Register as a developer
- Create an OAuth application and obtain an access token
- Set the
CONTA_AZUL_ACCESS_TOKENenvironment variable
Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| CONTA_AZUL_ACCESS_TOKEN | Yes | OAuth2 access token |
Roadmap
v0.2 (planned)
list_bank_accounts— List registered bank accountscreate_bank_account— Register a new bank accountlist_taxes— List tax entriescreate_tax— Create a tax entryget_cash_flow— Get cash flow summary report
v0.3 (planned)
reconciliation— Bank reconciliation toolsfinancial_reports— Generate financial summary reports
Want to contribute? Open a PR or request a tool.
Links
Enterprise
Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.
License
MIT
