Mollie MCP Server | Mollie Documentation

⚠️
You are responsible for all actions performed within your Mollie account by any AI tool that you connect, authorize or configure. Actions taken by an AI tool using your authorized access are treated in the same way as actions taken by you in the Mollie web app or using the API.
You are responsible for the permissions and authority you grant to the tool.
Mollie is not responsible for the decisions, outputs, errors or actions done by third-party AI tools, models or services that you choose to connect to your account.

The Mollie MCP server lets you connect AI tools like Claude, ChatGPT and Cursor to your Mollie account using natural language, without needing to open the Mollie web app first.
Once connected, your AI tool can check and manage balances, captures, invoices, payment links and other tools on your behalf (within the permission scope you grant it).

How it works

You sign in using Mollie's own login screen.

When you connect an AI tool, it redirects you to Mollie to sign in and approve the connection — you never type a password or paste an access key into the AI tool itself.

The AI tool can only do what your role already allows.

Connecting it doesn't grant any permissions beyond the ones you already have in your Mollie account.

The AI tool only performs actions when you ask it to.

If your AI tool has a setting to ask for permission to run an action: turn it on for anything that creates or changes something — a payment, a refund, a subscription etc.

Every action is attributed to you.

Anything done through a connected AI tool shows up in your account exactly as if you'd done it yourself - the same accountability as an API call or a manual click in the Dashboard.

You can disconnect your AI tool at any time.

Go to your AI tool's settings for connected apps or integrations and remove Mollie from there (see Managing or revoking access below)

Connect your AI tool

The Mollie MCP server is available at https://mcp.mollie.com/mcp. Claude, ChatGPT, Cursor, and other current-generation MCP clients support this out of the box - just add the URL to your client and it handles the rest automatically:

Your AI tool connects to https://mcp.mollie.com/mcp and sees that Mollie requires authentication.
You're redirected to Mollie's authorization screen (a webpage), where you sign in (if needed) and review the permissions your AI tool is requesting.
You approve the request. You can only ever grant the permissions your own account role already has - connecting an AI tool never gives it a broader scope than you already have.
You're redirected back to your AI tool, fully connected.

Any member of your organization can connect their own AI tool this way - it doesn't require an owner or admin to do so.

📘
This is the only supported way to connect: the previous static-token method has been deprecated. See below if you're using an older or less common MCP client.

Older or unsupported MCP clients

Claude, ChatGPT, Cursor and other current-generation clients all support this flow natively via CIMD (Client ID Metadata Documents). If you're on a client outside that set (or an older version that only supports local (stdio) servers), install the mcp-remote proxy package instead:

{
  "mcpServers": {
    "Mollie": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.mollie.com/mcp"]
    }
  }
}

The first time you connect, mcp-remote opens a browser window to the same Mollie authorization screen described above and stores the resulting tokens locally on your machine.

Managing or revoking access

At teh moment, there's no dedicated page in Mollie web app to manage AI tools' access. To revoke any access to your Mollie account, disconnect it from within the AI tool or code agent itself (for example, its connected-apps or integrations settings).

What you can do

Area	What you can ask
Payments	Look up a payment, list your recent payments, search by description, check totals over a period, create a new payment
Payment links	Create a shareable payment link, look one up, see who's paid it, check totals
Customers	List or search customers, view a customer's details, create a customer, charge an existing customer, update their details
Subscriptions	List subscriptions, view details, create a new one, update or cancel one
Mandates	List or view a customer's saved authorization for recurring charges, create or revoke one
Captures	List or view captures on an authorized payment, capture a held payment
Balances	Check your balance, see a balance report, view balance transactions
Settlements	List settlements (payouts to your bank account), see what's in your next or open settlement, view the payments, refunds, chargebacks, or captures behind one
Sales invoices	Create, list, view, or update invoices you send to your own customers
Invoices	List or view the invoices Mollie has billed you
Payment methods	See which methods are active on your account, or what's available for a given amount
Terminals	List or look up your point-of-sale terminals
Webhooks	Create, list, view, update, or test a webhook
Profiles	List or view your website profiles

📘
The Mollie MCP server doesn't currently support issuing refunds or cancelling a mandate/subscription cancellation beyond what's listed above.

Example prompts

Payments

What's the status of payment tr_7UhSN1zuXS?
Show me my last 10 payments
How much did I take in payments last month?
Search my payments for Order #4521
Create a €49.95 iDEAL payment, redirecting to example.com/thanks

Payment links

Create a payment link for €25 called Consulting session
Has anyone paid the payment link I sent yesterday?

Customers & subscriptions

Find the customer with email [email protected]
Set up a €9.99 monthly subscription for customer cst_8wmqcHMN54
Cancel the subscription for customer cst_8wmqcHMN54
List all subscriptions that are still active

Balances & settlements

What's my current balance?
What's in my next settlement?
Show me the refunds included in settlement stl_jDk30akdN

Sales invoices

Create a draft sales invoice for Acme Corp for €1,200, due in 30 days
List my unpaid sales invoices

Building your own Mollie integration or AI agent instead?

Check Mollie Agent skills guide - AI coding assistant know-how that turns on automatically while you build.
Check Agent toolkit guide - a code library for building your own AI agent or product on Mollie.

🚧
Privacy Notice for free-tier LLM users
Your conversations may be used for AI training. Most free-tier AI services retain and analyze your messages to improve their models. This means your questions, personal information, and discussions could become part of their training data.
To protect yourself:

Check the provider's privacy policy and opt-out options.

Consider paid tiers, which typically offer better privacy protections.

Remember: once shared, your data may be difficult or impossible to remove from training datasets.