# mcp-pluggy

Connect an agent to Pluggy to work with bank connections, accounts, transactions, and payment intents in Open Finance Brasil. Pluggy credentials are required.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/banking/pluggy
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-pluggy

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PLUGGY_CLIENT_ID`, `PLUGGY_CLIENT_SECRET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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 <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add pluggy --env PLUGGY_CLIENT_ID=<PLUGGY_CLIENT_ID> --env PLUGGY_CLIENT_SECRET=<PLUGGY_CLIENT_SECRET> -- npx -y @codespar/mcp-pluggy
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e PLUGGY_CLIENT_ID=<PLUGGY_CLIENT_ID> -e PLUGGY_CLIENT_SECRET=<PLUGGY_CLIENT_SECRET> pluggy npx -y @codespar/mcp-pluggy
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md