CLI and MCP server for the Qonto banking API.

This project is brought to you by Alexey Pelykh.

What It Does

QontoCtl lets AI assistants (Claude, etc.) interact with Qonto through the Model Context Protocol. It can:

• Organizations — retrieve organization details and settings
• Transactions — list, search, and filter bank transactions
• Labels — manage transaction labels and categories
• Memberships — view team members and permissions
• Invoices — upload, list, and manage supplier invoices
• Attachments — manage transaction attachments and receipts

Prerequisites

• Node.js >= 24
• A Qonto business account with API access

Installation

npm install -g qontoctl

Or run directly with npx:

npx qontoctl --help

Or install via Homebrew:

brew install qontoctl/tap/qontoctl

Usage with Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
    "mcpServers": {
        "qontoctl": {
            "command": "npx",
            "args": ["qontoctl", "mcp"]
        }
    }
}

CLI Usage

qontoctl --help
qontoctl mcp    # Start MCP server on stdio

Configuration

QontoCtl supports two authentication methods: API Key and OAuth 2.0.

Profile Format

All configuration files use the same YAML format:

api-key:
  organization_slug: acme-corp-4821
  secret_key: your-secret-key

oauth:
  client_id: app-id
  client_secret: app-secret
  access_token: eyJ...              # auto-managed
  refresh_token: dGhp...            # auto-managed
  expires_at: 2026-02-26T18:30:00Z  # auto-managed

Resolution Order

Without --profile:

1. QONTOCTL_* environment variables (highest priority)
2. .qontoctl.yaml in current directory
3. ~/.qontoctl.yaml (home default)

With --profile acme:

1. QONTOCTL_ACME_* environment variables (highest priority)
2. ~/.qontoctl/acme.yaml

OAuth takes precedence over API Key when tokens are valid. Expired tokens are refreshed automatically and written back to the source file.

Disclaimer

qontoctl is an independent project not affiliated with, endorsed by, or officially connected to Qonto or Qonto SAS.

Qonto is a trademark of Qonto SAS.

License

AGPL-3.0-only — For commercial licensing, contact the maintainer.