Build with the Lunch Money API
A personal finance & budgeting API built for developers
At Lunch Money, we believe your financial data belongs to you. Import from external systems, export at any time — no lock-in. Our OpenAPI-first design was shaped by real developer feedback, making it easy to build custom tools, automations, and visualizations that fit your exact workflow.
POST /v2/transactions
{
"transactions": [
{
"date": "2026-04-16",
"amount": -4.50,
"currency": "usd",
"payee": "Coffee Shop",
"category_id": 42,
"notes": "Morning latte"
}
],
"apply_rules": true
}GET /v2/summary
{
"categories": [
{
"category_id": 315177,
"totals": {
"other_activity": 156.64,
"recurring_activity": 0,
"budgeted": 500,
"available": 343.36,
"recurring_remaining": 0,
"recurring_expected": 0
},
"occurrences": [
{
"start_date": "2025-07-01",
"end_date": "2025-07-31",
"other_activity": 156.64,
"recurring_activity": 0,
"budgeted": 500,
"budgeted_amount": "500.0000",
"budgeted_currency": "usd",
"notes": "Monthly budget allocation"
},
{
"start_date": "2025-08-01",
"end_date": "2025-08-31",
"other_activity": 0,
"recurring_activity": 0,
"budgeted": 500,
"budgeted_amount": "500.0000",
"budgeted_currency": "usd",
"notes": "Adjusted for seasonal spending"
}
]
}
],
"totals": {
"inflow": {
"other_activity": -125.50,
"recurring_activity": -89.99,
"uncategorized": 0,
"uncategorized_count": 0,
"uncategorized_recurring": 0
},
"outflow": {
"other_activity": 581.44,
"recurring_activity": 0,
"uncategorized": 45.20,
"uncategorized_count": 3,
"uncategorized_recurring": 0
}
}
}GET /v2/categories
{
"categories": [
{
"id": 86,
"name": "Automobile",
"description": "Auto related categories",
"is_income": false,
"exclude_from_budget": false,
"exclude_from_totals": false,
"updated_at": "2025-02-28T09:49:03.238Z",
"created_at": "2025-01-28T09:49:03.238Z",
"is_group": true,
"order": 2,
"collapsed": false,
"archived": false,
"group_id": null,
"archived_at": null,
"children": [
{
"id": 315174,
"name": "Fuel",
"description": "Fuel and gas expenses",
"is_income": false,
"exclude_from_budget": false,
"exclude_from_totals": false,
"updated_at": "2025-02-28T09:49:03.238Z",
"created_at": "2025-01-28T09:49:03.238Z",
"is_group": false,
"order": 1,
"collapsed": false,
"archived": false,
"group_id": 86,
"archived_at": null
}
]
},
{
"id": 83,
"name": "Rent",
"description": "Monthly rent",
"is_income": false,
"exclude_from_budget": false,
"exclude_from_totals": false,
"updated_at": "2025-02-28T09:49:03.225Z",
"created_at": "2025-01-28T09:49:03.225Z",
"is_group": false,
"order": 0,
"collapsed": false,
"archived": false,
"group_id": null,
"archived_at": null
},
{
"id": 315180,
"name": "Groceries",
"description": null,
"is_income": false,
"exclude_from_budget": false,
"exclude_from_totals": false,
"updated_at": "2025-02-28T09:49:03.238Z",
"created_at": "2025-01-28T09:49:03.238Z",
"is_group": false,
"order": 1,
"collapsed": false,
"archived": false,
"group_id": null,
"archived_at": null
},
{
"id": 88,
"name": "W2 Income",
"description": null,
"is_income": true,
"exclude_from_budget": false,
"exclude_from_totals": true,
"updated_at": "2025-02-28T09:49:03.238Z",
"created_at": "2025-01-28T09:49:03.238Z",
"is_group": false,
"order": 3,
"collapsed": false,
"archived": false,
"group_id": null,
"archived_at": null
}
]
}Easy to get going
Play Instantly With The API
You can explore the API without writing code by using our interactive documentation. Experiment with a mock server or a sample budget before connecting your real financial data.
SDKs For Your Language
Our OpenAPI specification makes it easy to generate SDKs in your preferred language. Use a community-built SDK or generate your own to fit your workflow.
Get Support From The Community
Join our active Discord community to ask questions, share what you're building, and get help from other developers and the Lunch Money team.
Community Projects
Our developer community has built an incredible collection of open source tools, integrations, and apps. Whether you're looking to extend Lunch Money or build something new, there's probably a project here to inspire you.
MCP Servers 5 projects
Connect AI assistants like Claude to your Lunch Money data using the Model Context Protocol. Chat with AI about your spending and budget habits. Join the AI Tools channel on Discord.
Remote / Cloud-Deployable MCP Servers
Run Lunch Money MCP in your own cloud so you can use it from multiple devices, including Claude mobile, without installing it everywhere.
Client SDKs & API Wrappers 3 projects
Official and community-built libraries to interact with the Lunch Money API in your language of choice. Looking to generate your own? Install the Lunch Money v2 OpenAPI Spec.
V2 API
Open Source Mobile Apps 4 projects
Access and manage your Lunch Money data on the go with these open source mobile apps. Or try the official Lunch Money Mobile App.
Transaction Import Tools 10 projects
Import transactions from banks and services that aren't natively supported by Lunch Money.
Bookmarklets
Browser bookmarks that run JavaScript to import transactions after logging in to your bank's website. Don't see your bank? Join the Bookmarklets channel on Discord.
Transaction Update Tools 4 projects
Automatically categorize, enrich, and manage your existing Lunch Money transactions.
Notifiers & Bots 2 projects
Asset Value & Balance Tools 2 projects
Visualization Tools 4 projects
Cash Flow & Planning Tools 2 projects
Visualize and forecast your Lunch Money cash flow to plan ahead.
Extensions & Keyboard Shortcuts 3 projects
Other Notable Tools 3 projects
These projects aren't open source, but many Lunch Money users find them helpful.
The projects listed here are built and maintained by members of the Lunch Money community. Lunch Money does not make any commitments about the resources listed on this page, nor the accuracy of the third party resources and any content accessible via the links above.
