mcp-nubank — Claude Code MCP server: setup
This MCP server is designed to access Nubank accounts, PIX, cards, and boletos through Open Finance Brasil. Its current API endpoint is unreachable.
claude mcp add mcp-nubank -e NUBANK_CLIENT_ID=<NUBANK_CLIENT_ID> -- npx -y @codespar/mcp-nubankWhat mcp-nubank does
mcp-nubank is intended to expose Nubank account tools to an AI coding client. The planned operations cover balances, transactions, statements, card bills, investments, PIX transfers, PIX keys, and boleto payments.
Authentication uses OAuth2 client credentials together with an mTLS certificate. The process expects NUBANK_CLIENT_ID, NUBANK_CLIENT_SECRET, and NUBANK_CERT_PATH; a working provider address can be supplied through NUBANK_BASE_URL.
The package is deprecated because DNS currently fails for api.nubank.com.br, so none of its tools reaches a live service. Installing the MCP configuration does not restore access until a working endpoint is available.
What it helps with
- read a Nubank account balance
- inspect transactions and statements
- start or track PIX transfers
- manage registered PIX keys
- retrieve and pay boleto details
Example prompts for the agent
- Check my Nubank balance and recent transactions.
- Show the status and details of this PIX transfer.
- Look up the boleto by its barcode and prepare the payment.
How to install mcp-nubank
Platform CLI
claude mcp add mcp-nubank -e NUBANK_CLIENT_ID=<NUBANK_CLIENT_ID> -- npx -y @codespar/mcp-nubankReplace <…> with your own values
Platform CLI
codex mcp add nubank --env NUBANK_CLIENT_ID=<NUBANK_CLIENT_ID> -- npx -y @codespar/mcp-nubankReplace <…> with your own values
Config file
{
"mcpServers": {
"nubank": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nubank"
],
"env": {
"NUBANK_CLIENT_ID": "<NUBANK_CLIENT_ID>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"nubank": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nubank"
],
"env": {
"NUBANK_CLIENT_ID": "<NUBANK_CLIENT_ID>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e NUBANK_CLIENT_ID=<NUBANK_CLIENT_ID> nubank npx -y @codespar/mcp-nubankReplace <…> 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-nubank
How do I install mcp-nubank in Claude Code?
Run claude mcp add mcp-nubank -e NUBANK_CLIENT_ID=<NUBANK_CLIENT_ID> -- npx -y @codespar/mcp-nubank. The server also needs NUBANK_CLIENT_SECRET and NUBANK_CERT_PATH.
What does mcp-nubank do?
It is designed to give an agent tools for Nubank accounts, cards, PIX, statements, investments, and boletos through Open Finance Brasil.
Why does mcp-nubank fail to reach Nubank?
The package is deprecated, and api.nubank.com.br currently fails DNS resolution. Requests cannot reach the provider until a working address is supplied with NUBANK_BASE_URL.
