Lunch Money
Lunch Money is an MCP server that adds finance tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for managing LunchMoney personal finances: transactions, budgets, categories, and more. It has 115 GitHub stars, is released under the MIT license and runs locally with npx -y @akutishevsky/lunchmoney-mcp.
github.com/akutishevsky/lunchmoney-mcp (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
Install Lunch Money
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"lunch-money": {
"command": "npx",
"args": [
"-y",
"@akutishevsky/lunchmoney-mcp"
],
"env": {
"LUNCHMONEY_API_TOKEN": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env LUNCHMONEY_API_TOKEN=your-value --transport stdio lunch-money -- npx -y @akutishevsky/lunchmoney-mcpCursor
{
"mcpServers": {
"lunch-money": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@akutishevsky/lunchmoney-mcp"
],
"env": {
"LUNCHMONEY_API_TOKEN": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"inputs": [
{
"type": "promptString",
"id": "lunchmoney_api_token",
"description": "LUNCHMONEY_API_TOKEN",
"password": true
}
],
"servers": {
"lunch-money": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@akutishevsky/lunchmoney-mcp"
],
"env": {
"LUNCHMONEY_API_TOKEN": "${input:lunchmoney_api_token}"
}
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
LUNCHMONEY_API_TOKENsecret | Yes | Your LunchMoney API token. Obtain it from https://my.lunchmoney.app/settings/developer |
LUNCHMONEY_DEBUG | No | Set to 'true' to enable debug logging of API requests and responses to stderr |
Tools (40)
Parsed from the Tools section of the README; check the repository for the current list.
get_userRetrieve current user details
get_account_settingsGet account-wide settings (currencies, locale, display name, rule automation)
update_account_settingsUpdate account-wide settings (at least one field required)
get_user_settingsGet user-wide display and formatting preferences
update_user_settingsUpdate user-wide display and formatting preferences (at least one field required)
get_user_account_settingsGet user-specific settings within the budget account
update_user_account_settingsUpdate user-specific account settings, such as the default manual account (at least one field required)
get_all_categoriesList all categories (supports format and isgroup filters)
get_single_categoryGet details for a specific category or category group
create_categoryCreate a category or category group (set isgroup=true plus children)
update_categoryUpdate properties; replaces the children list on category groups
delete_categoryDelete a category; pass force=true to override dependency check
get_all_tagsList all tags
get_single_tagGet a tag by ID
create_tagCreate a new tag
update_tagUpdate tag properties
delete_tagDelete a tag (with force to override dependents)
get_transactionsList transactions with extensive filtering options (date range, account, category, tag, status, pending, metadata,…
get_single_transactionGet full transaction details (always includes plaidmetadata, custommetadata, files, and children for split/group…
create_transactionsInsert 1–500 transactions in one call
update_transactionPartial update of one transaction
delete_transactionDelete one transaction (cannot be split/group)
update_transactions_bulkBulk update 1–500 transactions
delete_transactions_bulkBulk delete 1–500 transactions by ID
create_transaction_groupCreate a transaction group from existing transactions
delete_transaction_groupUngroup a transaction group
split_transactionSplit a transaction into 2–500 children
unsplit_transactionUndo a previous split
attach_file_to_transactionUpload a local file (jpeg/png/heic/heif/pdf, ≤10MB), type verified from its contents
get_transaction_attachment_urlGet a signed download URL for a file attachment
delete_transaction_attachmentDelete a file attachment
get_recurring_itemsList recurring items for a date range (includesuggested for system suggestions)
get_single_recurring_itemGet a recurring item by ID
get_budget_summaryPer-category budget summary (backed by /summary); supports occurrences, totals, rollover-pool toggles
get_budget_settingsAccount-wide budget period and display settings
upsert_budgetCreate or update a budget for a category and period
remove_budgetRemove a budget for a category and period
get_all_manual_accountsList all manually-managed accounts (formerly "assets")
get_single_manual_accountGet a manual account by ID
create_manual_accountCreate a new manually-managed account
About Lunch Money
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.
- lunchmoney
- lunchmoney-api
- mcp
- mcp-server
- model-context-protocol
- mcpb
Similar MCP servers
More finance MCP servers
Dexpaprika MCP
coinpaprika/dexpaprika-mcp
DexPaprika MCP server for real-time crypto token data, DEX trading activity, and DeFi analytics across multiple blockchains.
Active · last commit Nov 13, 2026
FinanceJavaScriptDeepMem
deepmemteam/deepmem
Mem0-compatible persistent memory for AI agents: write facts once, recall them semantically.
Maintained · last commit Aug 17, 2026
FinancePythonthree.ws Notifications
nirholas/three.ws
Read the inbox, mark items read, manage delivery preferences, and register Web Push devices.
Active · last commit Nov 15, 2026
FinanceJavaScriptLuxAlgo MCP
LuxAlgo/luxalgo-mcp-server
LuxAlgo for AI agents: the Library, prop firms, Market Trackers, Edge Stats, and your Trade Journal.
Active · last commit Nov 7, 2026
FinanceTypeScriptRustchain MCP
Scottcjn/rustchain-mcp
MCP server for AI agents in the RustChain ecosystem: RTC credit wallets and signed transfers, bounty discovery, BoTTube video publishing, and Beacon agent-to-agent messaging.
Active · last commit Oct 4, 2026
FinancePythonU.S. Government Open Data
lzinga/us-gov-open-data-mcp
Open data from 40+ U.S. government APIs: economy, spending, Congress, health, energy, disasters.
Active · last commit Oct 26, 2026
FinanceTypeScript
How do I install the Lunch Money MCP server?
Add the command npx -y @akutishevsky/lunchmoney-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is Lunch Money free?
The server is open source under the MIT license, so running it is free. It needs credentials (LUNCHMONEY_API_TOKEN) for the service it connects to, which may require a paid account.
Is Lunch Money actively maintained?
The most recent commit was on Nov 8, 2026. The latest release is mcpb-4.0.1, published Nov 8, 2026. appsgit only lists MCP servers with a commit in the last six months.