Projected Cash Flow

🔑Lunch Money Integration Setup

Step-by-step guide to connect your Lunch Money account for automatic transaction import

Last updated: 1/21/2025
lunchmoneysetupintegration

Lunch Money Integration

Projected Cash Flow integrates with Lunch Money to automatically import your financial data and create accurate cash flow projections.

What is Lunch Money?

Lunch Money is a personal finance and budgeting tool that:

  • Connects to your bank accounts
  • Categorizes transactions automatically
  • Tracks spending and income
  • Provides budgeting tools

Why We Use Lunch Money

We integrate with Lunch Money because:

  • Bank connections - They handle the complex bank integrations securely
  • Data organization - Transactions are already categorized and cleaned
  • Security - Your bank credentials stay with Lunch Money, not us
  • Real-time sync - Get updated data automatically

Setting Up the Integration

Step 1: Create a Lunch Money Account

If you don't have a Lunch Money account:

  1. Go to lunchmoney.app
  2. Sign up for an account
  3. Connect your bank accounts
  4. Let Lunch Money import and categorize your transactions

Tip: Lunch Money offers a free trial. Make sure your transactions are imported before connecting to Projected Cash Flow.

Step 2: Generate an API Key

  1. Log into your Lunch Money account
  2. Navigate to Settings → Developer API
  3. Click "Request Access Token"
  4. Give it a descriptive name like "Projected Cash Flow"
  5. Copy the token immediately - you won't see it again!

Step 3: Add Key to Projected Cash Flow

  1. In Projected Cash Flow, go to Settings → API Keys
  2. Click "Add API Key"
  3. Select "Lunch Money" as the provider
  4. Paste your API key
  5. Give it a friendly name (optional)
  6. Click "Save"

What Data We Access

When you connect Lunch Money, we can access:

What we use:

  • Account balances
  • Transaction history
  • Recurring transactions
  • Transaction categories

What we DON'T access:

  • Your Lunch Money password
  • Your bank credentials
  • Personal notes on transactions
  • Budget configurations

Security

How We Protect Your Data

  • Encryption: API keys are encrypted with AES-256-GCM
  • Limited scope: We only request read access
  • No storage: Transaction data is fetched on-demand
  • Secure connection: All API calls use HTTPS

Best Practices

  1. Use a descriptive name for your API key in Lunch Money
  2. Rotate keys periodically for extra security
  3. Remove unused keys from both Lunch Money and our app
  4. Monitor access in Lunch Money's developer settings

Troubleshooting

"Invalid API Key" Error

  • Double-check you copied the entire key
  • Ensure there are no extra spaces
  • Try generating a new key in Lunch Money

Missing Transactions

  • Verify transactions appear in Lunch Money first
  • Check the date range in your projections
  • Refresh your data in Settings

Account Not Showing

  • Confirm the account is active in Lunch Money
  • Check if it's a supported account type
  • Try disconnecting and reconnecting

Managing Your Connection

Update API Key

  1. Go to Settings → API Keys
  2. Click the edit icon next to your key
  3. Enter the new key
  4. Save changes

Disconnect Lunch Money

  1. Go to Settings → API Keys
  2. Click the delete icon
  3. Confirm deletion

This removes our access immediately.

Need Help?