Pluggy is the fastest way to add Open Finance Brasil and account aggregation to your application. This repository is a hands-on tour of every officially supported integration shape — pick the one that matches your stack, copy it, and you're integrated in minutes.
Looking for the API reference instead? Head to docs.pluggy.ai.
- Get started
- One-click deploy
- Examples in this repo
- Official SDKs and widgets
- AI agent tools
- Reference and community projects
- Resources
- Contributing
- Create an account at dashboard.pluggy.ai
- Create an application to get your Client ID and Client Secret
- Pick a quickstart below that matches your stack and follow its
README.md
Every server-side example here implements the same two-token pattern:
- API key (server-side only) — created from
CLIENT_ID+CLIENT_SECRET - Connect token (client-side safe) — scoped to a single widget session, exchanged from the API key
The Connect Widget never sees your CLIENT_SECRET.
The flagship vercel-quickdeploy-nextjs example — Next.js 16 + Supabase + Connect Widget + webhook-driven sync — deploys in under two minutes. You only need to supply your Pluggy and Supabase credentials.
Client-side integrations that drop the Pluggy Connect Widget into a page. See frontend/README.md for the connect-token flow and widget configuration.
| Stack | Path | Notes |
|---|---|---|
| Next.js (Pages Router) | frontend/nextjs | Next.js 15 + server-side token via /api/token |
| React | frontend/react | React 19 + CRA |
| React Native (Expo) | frontend/react-native-expo | Expo SDK 54 + Expo Router |
| React Native (bare) | frontend/react-native | RN 0.66 bare workflow (legacy reference) |
| Flutter | frontend/flutter | Flutter + WebView |
| Vanilla HTML | frontend/html | Drop-in CDN script |
| Flask | frontend/flask | Python Flask + server-rendered templates |
| Cordova | frontend/cordova | Apache Cordova iOS |
Server-side examples that issue connect tokens, receive Pluggy webhooks, and persist items / transactions.
| Stack | Path | Notes |
|---|---|---|
| Vercel + Next.js + Supabase | examples/vercel-quickdeploy-nextjs | Flagship full-stack example. App Router, RLS-backed Supabase, webhook-driven sync. |
| NestJS + Postgres | examples/node-nestjs | NestJS 11 + Sequelize + PostgreSQL via docker-compose |
| Vercel serverless (token only) | examples/vercel-node-connect-token | Minimal connect-token endpoint |
| Vercel + MongoDB | examples/vercel-node-mongo | Token endpoint + webhook persistence in MongoDB |
| AWS (SST v4) | examples/aws-sst | Lambda + DynamoDB on SST Ion |
| Java + Spring Boot | java | Spring Boot 2.6 |
| Platform | Path |
|---|---|
| iOS (Swift) | ios |
| Language / target | Source | Package |
|---|---|---|
| Node.js / TypeScript (server) | pluggyai/pluggy-node | pluggy-sdk |
| Browser JavaScript | pluggyai/pluggy-js | pluggy-js |
| Java | pluggyai/pluggy-java | Maven Central |
| .NET / C# | pluggyai/pluggy-net | NuGet |
Connect Widget components:
| Target | Package |
|---|---|
| React | react-pluggy-connect |
| React Native | react-native-pluggy-connect |
| Browser (CDN / vanilla) | pluggy-connect-sdk |
For coding agents (Claude Code, Cursor, GitHub Copilot, …) building on top of Pluggy:
| Tool | What it is | Install |
|---|---|---|
| pluggyai/agent-skills | Agent Skills that teach agents how to integrate Pluggy — SDK setup, Connect Widget, Item lifecycle, webhooks, Open Finance data retrieval. Format: agentskills.io. | npx skills add pluggyai/agent-skills |
| pluggyai/pluggy-mcp | MCP server exposing the Pluggy API as tools to any MCP-compatible client (Cursor, Claude Desktop, …). | See repo README |
Larger real-world projects that build on top of Pluggy:
| Project | What it is |
|---|---|
| pluggyai/my-expenses — live | Full-stack personal-finance example app. The most complete open Pluggy integration. |
| pluggyai/meu-pluggy — live | Free consumer wallet for Open Finance Brasil. Consent & data management. |
| pluggyai/use-pluggy-connect | React hook wrapper around the Connect Widget. |
| pluggyai/raycast-pluggy | Raycast extension that surfaces Pluggy data on the desktop. |
- Pluggy Documentation
- Pluggy API Reference
- Pluggy Connect Widget Docs
- Pluggy Dashboard
- Pluggy on GitHub — all public Pluggy repos
- Pluggy status / changelog
This repository is open for contributions. Each subdirectory is an independent project with its own README.md, dependencies, and instructions. See CLAUDE.md for an architectural overview of how the projects are laid out.
All PRs require review from @pluggyai/ramen and @pluggyai/tech-leaders (see .github/CODEOWNERS).