Cash Page for AI and developers
Let AI assistants read and write your Cash Page books over MCP, or build your own tools with the REST API.
Connect an AI assistant
Cash Page runs a remote MCP server at https://cashpage.app/mcp. Add it to your AI app, sign in to Cash Page and click Allow. No key to copy.
- Claude (claude.ai, desktop): Settings → Connectors → Add custom connector. Name: Cash Page. URL: the address above.
- ChatGPT: Settings → Apps & Connectors → Advanced → turn on Developer mode, then Create. Name: Cash Page. URL: the address above.
- Cursor, VS Code: Use the one-click buttons under Connect AI in the app, or add the URL to your MCP settings.
- Claude Code: Run the command below, then type /mcp and sign in.
claude mcp add --transport http cash-page https://cashpage.app/mcp
Then ask things like “What did I spend on software this quarter?” or “Log a $75 Figma expense from my Wise USD account yesterday.”
What the AI can do
Tools the AI can call. Write tools only work if you allowed write access.
get_overviewYour books, base currency, today's date and this month's totals.list_money_accountsMoney accounts with currency and balance.list_categoriesIncome and expense categories.list_transactionsFind transactions by date, kind, text, account or category.add_transactionRecord money in, money out or a transfer.update_transactionChange fields of a transaction.delete_transactionDelete a transaction.create_categoryCreate a category.get_month_summaryIncome, expenses and net for a month.get_profit_and_lossProfit and loss by category, with the previous period.get_cash_flowOpening, money in/out and closing per account.
REST API
Base URL https://cashpage.app/api/v1. Send a key from Settings → API & AI as Authorization: Bearer cp_key_…. Use default as {book} for your first book. Amounts are numbers in the transaction’s currency; accounts and categories can be given by name.
- GET
/meYour profile, access level and books. - GET
/booksList books. - GET
/books/{book}/accountsMoney accounts with balances. - GET · POST
/books/{book}/categoriesList or create categories. - GET · POST
/books/{book}/transactionsList (from, to, kind, search, limit) or create. - GET · PATCH · DELETE
/books/{book}/transactions/{id}Read, update or delete one transaction. - GET
/books/{book}/reports/summary?month=YYYY-MMMonth totals. - GET
/books/{book}/reports/profit-and-loss?from&toProfit and loss. - GET
/books/{book}/reports/cash-flow?from&toCash flow.
Example: add an expense
curl -X POST https://cashpage.app/api/v1/books/default/transactions \
-H "Authorization: Bearer cp_key_…" \
-H "Content-Type: application/json" \
-d '{"kind":"expense","amount":75,"currency":"USD",
"account":"Wise USD","category":"Software","note":"Figma"}'Limits and security
- Free plan: 100 API and MCP calls per day (resets 00:00 UTC). Pro: unlimited, with a fair-use rate limit of 120 requests per minute.
- Keys and access tokens are stored only as hashes. Revoke a key or disconnect an app any time in Settings.
- AI apps connect with OAuth 2.1 (PKCE). Access tokens last 1 hour and refresh automatically.
- Errors return JSON: { "error": { "code", "message" } } with the HTTP status (400, 401, 403, 404, 429).