MCP server for managing LunchMoney personal finances: transactions, budgets, categories, and more.
Most developer tooling work still happens through a UI a human drives. Lunch Money MCP server moves it into the conversation instead. MCP server for managing LunchMoney personal finances: transactions, budgets, categories, and more.
A Model Context Protocol (MCP) server implementation for LunchMoney, providing programmatic access to personal finance management through LunchMoney's API. Also available as an MCP Bundle (.mcpb) for easy installation in Claude Desktop.
This MCP server enables AI assistants and other MCP clients to interact with LunchMoney data, allowing for automated financial insights, transaction management, budgeting, and more.
Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.
The server publishes 14 tools. What each one is for:
get_user — Retrieve current user detailsget_all_categories — List all categories (supports format and is_group filters)get_single_category — Get details for a specific category or category groupcreate_category — Create a category or category group (set is_group=true plus children)update_category — Update properties; replaces the children list on category groupsdelete_category — Delete a category; pass force=true to override dependency checkget_all_tags — List all tagsget_single_tag — Get a tag by IDcreate_tag — Create a new tagupdate_tag — Update tag propertiesdelete_tag — Delete a tag (with force to override dependents)get_transactions — List transactions with extensive filtering options (date range, account, category, tag, status, pending, metadata, files, etc)Configuration is passed through the environment: LUNCHMONEY_API_TOKEN, LUNCHMONEY_DEBUG. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Lunch Money's toolset — get_user, get_all_categories, get_single_category and 11 more — is a fair guide to whether it matches your workflow. It is maintained by akutishevsky; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Lunch Money's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| get_user | Retrieve current user details |
| get_all_categories | List all categories (supports format and is_group filters) |
| get_single_category | Get details for a specific category or category group |
| create_category | Create a category or category group (set is_group=true plus children) |
| update_category | Update properties; replaces the children list on category groups |
| delete_category | Delete a category; pass force=true to override dependency check |
| get_all_tags | List all tags |
| get_single_tag | Get a tag by ID |
| create_tag | Create a new tag |
| update_tag | Update tag properties |
| delete_tag | Delete a tag (with force to override dependents) |
| get_transactions | List transactions with extensive filtering options (date range, account, category, tag, status, pending, metadata, files, etc) |
| get_single_transaction | Get full transaction details (always includes plaid_metadata, custom_metadata, files, and children for split/group parents) |
| create_transactions | Insert 1–500 transactions in one call |
{
"mcpServers": {
"lunchmoney": {
"command": "npx",
"args": ["-y", "@akutishevsky/lunchmoney-mcp"],
"env": {
"LUNCHMONEY_API_TOKEN": "your-value",
"LUNCHMONEY_DEBUG": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| LUNCHMONEY_API_TOKEN | Credential the server authenticates with. | Yes |
| LUNCHMONEY_DEBUG | Configuration value read at startup. | Optional |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.