Bunq

Bunq (neo bank) MCP server

typescript

7

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "wilcokruijer-bunq-mcp": {
      "command": "bunq-mcp",
      "args": [
        "--mcp",
        "--bunq-client-id",
        "<client-id>",
        "--bunq-client-secret",
        "<client-secret>"
      ],
      "env": {
        "BUNQ_API_KEY": "YOUR_API_KEY",
        "BUNQ_CLIENT_ID": "<client-id>",
        "BUNQ_CLIENT_SECRET": "<client-secret>"
      }
    }
  }
}

You run a Bunq MCP Server that exposes Bunq bank capabilities through the Model Context Protocol. It lets you fetch accounts, view transactions, create payment requests, and perform other Bunq-driven actions from your MCP clients in a secure and structured way.

How to use

Connect an MCP client to your Bunq MCP Server to access Bunq data and actions. You will authenticate using either OAuth or an API key, then run commands through MCP to list accounts, fetch transactions, create payment requests, and initiate (draft or real-money) payments depending on your setup. The server responds with structured data for each supported tool so you can display balances, recent activity, counterparties, and more in your application.

Typical usage patterns include: getting a list of Bunq accounts, inspecting recent transactions for a selected account, generating a payment request to receive funds, and creating a draft or real payment when you have the appropriate permissions. Your MCP client can issue the corresponding tool requests in a flow that matches your UI, automation, or reporting needs.

How to install

Prerequisites you need before installation: Node.js and npm, or a compatible runtime for MCP tooling.

Install the MCP and remote client tooling globally so you can run and configure the server from any terminal.

npm install -g bunq-mcp mcp-remote

Configure and run the Bunq MCP Server

Create an OAuth client or API key in the Bunq app to enable authentication. You will either use the client ID/secret for OAuth or an API key for direct API access.

Optional: generate a new public/private key pair for secure signing if you plan to use OAuth.

bunq-mcp --generate-keys

Start the MCP server using your Bunq credentials. Replace the placeholders with your actual values. You may also set credentials via environment variables instead of command line arguments.

bunq-mcp --mcp --bunq-client-id <client-id> --bunq-client-secret <client-secret>

If you prefer to pass credentials as environment variables instead of CLI arguments, set them before starting the server.

export BUNQ_CLIENT_ID=<client-id>
export BUNQ_CLIENT_SECRET=<client-secret>
bunq-mcp --mcp

Available tools

bunqAccounts

Get a list of Bunq accounts with details such as account type, balance, and ID.

getTransactions

Retrieve transactions for a specific Bunq account, including payments.

getRequestInquiries

Fetch money requests you've sent from a specific Bunq account.

createPaymentRequest

Create a payment request to receive money into your Bunq account.

getPaymentAutoAllocates

Obtain automatic payment allocation settings for an account.

getTopCounterparties

List unique person counterparties based on recent transactions.

createDraftPayment

Create draft payments with optional scheduling; requires review/approval in the Bunq app.

createPayment

Create real-money payments (transfers immediately) when using an API key.