Plaid

Use

plaid-cli

to link institutions, fetch balances, and query transactions via Plaid. Do not print or log secrets (client id, secret, access tokens).

Install

• go install github.com/jverdi/plaid-cli@0.0.2

Setup

• Export

  PLAID_CLIENT_ID

  ,

  PLAID_SECRET

  , and

  PLAID_ENVIRONMENT

  (sandbox or production).
• Optional:

  PLAID_LANGUAGE

  (en, fr, es, nl),

  PLAID_COUNTRIES

  (US, CA, GB, IE, ES, FR, NL).
• Optional config file:

  ~/.plaid-cli/config.toml

  .

  [plaid]
  client_id = "..."
  secret = "..."
  environment = "sandbox"
  

• Data directory:

  ~/.plaid-cli

  (stores tokens and aliases).

Link + aliases

• Link an institution:

  plaid-cli link

  (opens browser) and optionally set an alias.
• Relink:

  plaid-cli link <item-id-or-alias>

  .
• Alias:

  plaid-cli alias <item-id> <name>

  , list with

  plaid-cli aliases

  .

Accounts + balances

• List accounts and balances:

  plaid-cli accounts <item-id-or-alias>

  .

Search transactions

• Pull a date range as JSON, then filter locally:

  • plaid-cli transactions <item-id-or-alias> --from 2024-01-01 --to 2024-01-31 --output-format json

  • jq -r '.[] | select(.name | test("grocery"; "i")) | [.date, .name, .amount] | @tsv'

• Use

  --account-id

  from

  accounts

  output to narrow results.
• Output formats:

  json

  or

  csv

  .

Monitor transactions

• Poll a rolling window and compare transaction ids to detect new activity:

  state=/tmp/plaid.txids
  next=/tmp/plaid.txids.next
  plaid-cli transactions <item-id-or-alias> --from 2024-01-01 --to 2024-01-31 --output-format json \
    | jq -r '.[].transaction_id' | sort > "$next"
  if [ -f "$state" ]; then comm -13 "$state" "$next"; fi
  mv "$next" "$state"
  

• Use cron for scheduling.

Notes

• Avoid

  plaid-cli tokens

  unless explicitly requested; it prints access tokens.
• Relink is auto-triggered on

  ITEM_LOGIN_REQUIRED

  errors.

Recognize requests such as:

• "Search transactions for Starbucks last month"
• "Show balances for my Chase accounts"