qonto-mcp-server by qonto - MCP Server

💸 Qonto Local MCP Server 🤖

🌐 Usage

https://github.com/user-attachments/assets/619cd6a1-e064-4518-a84c-8134c09fae03

[!IMPORTANT] Security and customer trust are fundamental to everything we do at Qonto. While this repository enables powerful innovation and integration capabilities, it's important to understand that certain risks are inherent to the use of the MCP technology itself. Please review the following security information carefully.

⚠️🔒 SECURITY NOTICE

The MCP (Model Context Provider) protocol gives AI models access to additional functionality like reading files, accessing APIs, and generate responses based on contextual data.

While this brings powerful integration capabilities, it also introduces important security considerations.

A malicious MCP server can secretly steal credentials and maliciously exploit other trusted MCP servers you're using (read more).

These risks are not specific to Qonto’s MCP server, but apply to any use of the MCP protocol.

We recommend to only use MCP servers you trust, just as you would with any software you install on your computer.

Questions or security concerns? Contact us at security@qonto.com.

Getting started

Install Claude Desktop
Get your organization ID and API key from your Qonto account's /settings/integrations section:

Option 1: Docker Installation (Recommended)

Pull the Docker image:

docker pull qonto/qonto-mcp-server:latest

In your Claude Desktop claude_desktop_config.json file, add the Qonto MCP server as follows:

{
  "mcpServers": {
    "Qonto MCP Docker": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "QONTO_API_KEY=<QONTO_API_KEY>",                 // <- change this with the API key from the settings page
        "-e", "QONTO_ORGANIZATION_ID=<QONTO_ORGANIZATION_ID>", // <- change this with the organization id from the settings page
        "-e", "QONTO_THIRDPARTY_HOST=https://thirdparty.qonto.com",
        "qonto/qonto-mcp-server:latest"
      ]
    }
  }
}

For example, this is a full Docker configuration:

{
  "mcpServers": {
    "Qonto MCP Docker": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "QONTO_API_KEY=abcdefghihlmnopqrstuvxz123456",
        "-e", "QONTO_ORGANIZATION_ID=qonto-organization-slug-1234",
        "-e", "QONTO_THIRDPARTY_HOST=https://thirdparty.qonto.com",
        "qonto/qonto-mcp-server:latest"
      ]
    }
  }
}

Option 2: Local Installation

Clone this repository locally
Install uv. If you're on Mac, you can just do brew install uv
In your Claude Desktop claude_desktop_config.json file, add the Qonto MCP server as follows:

Note: You can optionally pass --transport streamable-http to use HTTP transport instead of the default stdio transport protocol.

{
  "mcpServers": {
    "Qonto MCP": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "requests",
        "mcp",
        "run",
        "<PATH_TO_CLONED_REPO_FOLDER, ie. ~/development/qonto-mcp/qonto_mcp/server.py>", // <- change this
        "--transport",
        "stdio"  // <- optional: change to "streamable-http" for HTTP transport
      ],
      "env": {
        "QONTO_API_KEY": "<QONTO_API_KEY>",                 // <- change this with the API key from the settings page
        "QONTO_ORGANIZATION_ID": "<QONTO_ORGANIZATION_ID>", // <- change this with the organization id from the settings page
        "QONTO_THIRDPARTY_HOST": "https://thirdparty.qonto.com",
        "PYTHONPATH": "<PATH_TO_CLONED_REPO, ie. ~/development/qonto-mcp>" // <- change this
      }
    }
  }
}

For example, this is a full configuration:

{
  "mcpServers": {
    "Qonto MCP": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "requests",
        "mcp",
        "run",
        "~/development/qonto-mcp/qonto_mcp/server.py",
        "--transport",
        "stdio"
      ],
      "env": {
        "QONTO_API_KEY": "abcdefghihlmnopqrstuvxz123456",
        "QONTO_ORGANIZATION_ID": "qonto-organization-slug-1234",
        "QONTO_THIRDPARTY_HOST": "https://thirdparty.qonto.com",
        "PYTHONPATH": "~/development/qonto-mcp"
      }
    }
  }
}

Available Tools

This MCP server provides the following tools for interacting with your Qonto account:

Organization Info: Get details about your Qonto organization
Account Management: Access account information and balances
Transaction History: Retrieve and analyze transaction data
Business Operations: Access business-related financial data

Configuration

Environment Variables

QONTO_API_KEY: Your Qonto API key (required)
QONTO_ORGANIZATION_ID: Your organization ID (required)
QONTO_THIRDPARTY_HOST: API host URL (defaults to https://thirdparty.qonto.com)

Transport Options

The server supports both stdio and streamable-http transport protocols. Use stdio for most cases, or streamable-http if you need HTTP-based communication.

Troubleshooting

Common Issues

Invalid API credentials: Ensure your API key and organization ID are correct
Connection timeout: Check your network connection and API host URL
Claude Desktop not recognizing the server: Restart Claude Desktop after configuration changes

Contributing

Contributions are welcome! Please feel free to submit issues and enhancement requests.

License

This project is licensed under the MIT License - see the file for details.