Plaid Integration

What it does

This skill enables AI agents to securely connect to users' bank accounts and retrieve financial data using the Plaid API within TypeScript applications built with Bun. It facilitates linking user accounts, exchanging tokens, and syncing transaction history. The integration provides tools for handling errors and managing pagination when retrieving large volumes of transaction data.

When to use it

• Building a personal finance application that requires access to users' bank account information.
• Automating financial reporting or analysis tasks by pulling transaction data directly from user accounts.
• Developing applications needing to categorize and track spending habits based on bank transactions.
• Creating tools for budgeting and financial planning that rely on real-time banking data.

Key capabilities

• Link Token Creation: Generates a link token to initiate the Plaid Link flow, supporting both redirect and popup modes.
• Token Exchange: Exchanges temporary public tokens for permanent access tokens.
• Transaction Retrieval: Retrieves transaction history with pagination (maximum 500 transactions per request).
• Error Handling: Provides mechanisms for catching and handling common Plaid API errors like ITEM_LOGIN_REQUIRED, INVALID_ACCESS_TOKEN, and PRODUCT_NOT_READY.
• Database Integration: Supports integration with Bun SQLite databases to store account, transaction, and other related data.

Example prompts

• "Connect to my bank account using Plaid."
• "Retrieve all transactions from the last month via Plaid."
• "Get a list of accounts linked through Plaid."

Tips & gotchas

• Requires setting environment variables for PLAID_ENV, PLAID_CLIENT_ID, and PLAID_SECRET.
• Be mindful of pagination when retrieving transactions; always process results in batches.
• Securely store access tokens—never expose them to clients.