Documentation

Cashflow is a personal financial ledger exposed as MCP tools for AI agents. Connect it to Claude, ChatGPT, or any MCP-compatible assistant to query and manage your finances in natural language.

Get started

Server URL

https://cashflow.tech/api/mcp

Add this URL as an MCP integration in your AI client’s settings.

Setup

  1. Open Claude.ai or ChatGPT→ Settings → Integrations
  2. Click Add Integration and paste the server URL above
  3. Authorize with Google Sign-In
  4. Start a new conversation — Cashflow tools are available immediately

Claude Code: claude mcp add cashflow https://cashflow.tech/api/mcp

Authentication

Cashflow uses OAuth 2.0 with PKCE. When you add the server URL, your MCP client handles the OAuth flow automatically — you just sign in with Google. No API keys needed.

To explore without connecting a bank account, click “See demo data” on the authorization page. This grants access to a sample dataset so you can try all the tools first.

Tools

query read-only

Unified financial query tool with auto-detected modes: spending summaries, grouped breakdowns, time series trends, P&L statements, transaction detail, recurring bill detection, cash flow forecasting, anomaly detection, inter-account flows, and data health checks. Supports filtering by category, party, account, tags, date range, and amount.

annotate non-destructive

Classify and organize transactions. Set categories, parties, tags. Mark transfers or ignored transactions. Apply rules in bulk. Detect recurring series. All changes are reversible — raw bank data is never modified.

admin write

Manage reference data: categories, category groups, parties, tags, accounts, recurring series, and transaction rules. Supports list, create, rename, merge, delete, and deactivate. Rules use a specificity-based engine with a preview-before-create workflow.

Usage Examples

In practice you just describe what you want in natural language. These show the underlying query tool parameters for reference.

Monthly spending summary

Returns income, expenses, and net totals with month-over-month comparison and financial ratios.

{
  "period": "this_month",
  "compare": "prior_period",
  "include": [
    "ratios"
  ]
}

Recurring bills audit

Lists all detected recurring charges with frequency, amounts, and a 60-day forecast of upcoming payments.

{
  "recurring": true,
  "forecast_days": 60
}

Category drill-down with anomalies

Breaks down expenses by category group with anomaly detection — spending spikes, unusual charges, and price changes.

{
  "by": [
    "group"
  ],
  "type": "expense",
  "period": "this_month",
  "include": [
    "anomalies"
  ]
}

Transaction search

Searches transaction descriptions across all time, returning individual transactions with amounts, dates, and categories.

{
  "detail": true,
  "search": "Amazon",
  "period": "last_3_months"
}

Privacy

Cashflow only accesses financial data you explicitly connect. Your data is stored securely and is never shared with third parties. See the privacy policy for details.