mcp-pluggy — Pluggy MCP server for Claude Code
Connect an agent to Pluggy to work with bank connections, accounts, transactions, and payment intents in Open Finance Brasil. Pluggy credentials are required.
claude mcp add mcp-pluggy -e PLUGGY_CLIENT_ID=<PLUGGY_CLIENT_ID> -e PLUGGY_CLIENT_SECRET=<PLUGGY_CLIENT_SECRET> -- npx -y @codespar/mcp-pluggyWhat mcp-pluggy does
The server exposes 16 tools for finding bank connectors, creating and managing connections, and retrieving account, transaction, and identity records. Agents can also create a payment intent and check its status.
Set PLUGGY_CLIENT_ID and PLUGGY_CLIENT_SECRET to authenticate. The server obtains an API key through Pluggy’s OAuth2 client-credentials flow and uses it for later requests. Pluggy offers sandbox connectors backed by synthetic account and transaction data. This integration targets Pluggy and Open Finance Brasil, so you’ll need valid Pluggy credentials to use it.
What it helps with
- search Pluggy bank connectors by criteria
- create or revoke a bank connection
- retrieve accounts and transactions for a date range
- fetch identity details linked to a connection
- start a payment intent and check its status
Example prompts for the agent
- Find Pluggy bank connectors available in the sandbox.
- Show accounts and transactions for connection
<id>over the requested dates. - Create a payment intent and check its status.
How to install mcp-pluggy
Platform CLI
claude mcp add mcp-pluggy -e PLUGGY_CLIENT_ID=<PLUGGY_CLIENT_ID> -e PLUGGY_CLIENT_SECRET=<PLUGGY_CLIENT_SECRET> -- npx -y @codespar/mcp-pluggyReplace <…> with your own values
Platform CLI
codex mcp add pluggy --env PLUGGY_CLIENT_ID=<PLUGGY_CLIENT_ID> --env PLUGGY_CLIENT_SECRET=<PLUGGY_CLIENT_SECRET> -- npx -y @codespar/mcp-pluggyReplace <…> with your own values
Config file
{
"mcpServers": {
"pluggy": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-pluggy"
],
"env": {
"PLUGGY_CLIENT_ID": "<PLUGGY_CLIENT_ID>",
"PLUGGY_CLIENT_SECRET": "<PLUGGY_CLIENT_SECRET>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"pluggy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-pluggy"
],
"env": {
"PLUGGY_CLIENT_ID": "<PLUGGY_CLIENT_ID>",
"PLUGGY_CLIENT_SECRET": "<PLUGGY_CLIENT_SECRET>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e PLUGGY_CLIENT_ID=<PLUGGY_CLIENT_ID> -e PLUGGY_CLIENT_SECRET=<PLUGGY_CLIENT_SECRET> pluggy npx -y @codespar/mcp-pluggyReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-pluggy
How do I install mcp-pluggy in Claude Code?
Run claude mcp add mcp-pluggy -e PLUGGY_CLIENT_ID=<PLUGGY_CLIENT_ID> -e PLUGGY_CLIENT_SECRET=<PLUGGY_CLIENT_SECRET> -- npx -y @codespar/mcp-pluggy. Replace the placeholders with your Pluggy credentials.
What does mcp-pluggy do?
It gives an agent access to Pluggy operations, including bank connections, account and transaction records, identity details, and payment intents.
What credentials does mcp-pluggy need?
Set PLUGGY_CLIENT_ID and PLUGGY_CLIENT_SECRET from the Pluggy dashboard. Pluggy’s sandbox connectors can be used with synthetic account and transaction data.
