# Lunch Money (MCP server) > 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 109 GitHub stars, is released under the MIT license and runs locally with npx -y @akutishevsky/lunchmoney-mcp. 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. ## Key facts | Fact | Value | |---|---| | Repository | https://github.com/akutishevsky/lunchmoney-mcp | | GitHub stars | 109 | | License | MIT | | Language | TypeScript | | Transport | stdio | | Packages | npm: @akutishevsky/lunchmoney-mcp | | Remote URL | none | | Needs API key | yes | | Official | no | | Works with | Claude Desktop, Claude Code, Cursor, VS Code | | Category | Finance | | Latest release | mcpb-3.0.0 (Aug 3, 2026) | | Last commit | Aug 3, 2026 | | MCP registry name | io.github.akutishevsky/lunchmoney-mcp | ## Install ### Claude Desktop (claude_desktop_config.json) ```json { "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 ```sh claude mcp add --env LUNCHMONEY_API_TOKEN=your-value --transport stdio lunch-money -- npx -y @akutishevsky/lunchmoney-mcp ``` ### Cursor (.cursor/mcp.json) ```json { "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 (.vscode/mcp.json) ```json { "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 2026-10-07. ## Environment variables - `LUNCHMONEY_API_TOKEN` (secret) (required): Your LunchMoney API token. Obtain it from https://my.lunchmoney.app/settings/developer - `LUNCHMONEY_DEBUG`: Set to 'true' to enable debug logging of API requests and responses to stderr ## Tools - `get_user`: Retrieve current user details - `get_all_categories`: List all categories (supports format and isgroup filters) - `get_single_category`: Get details for a specific category or category group - `create_category`: Create a category or category group (set isgroup=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,… - `get_single_transaction`: Get full transaction details (always includes plaidmetadata, custommetadata, files, and children for split/group… - `create_transactions`: Insert 1–500 transactions in one call - `update_transaction`: Partial update of one transaction - `delete_transaction`: Delete one transaction (cannot be split/group) - `update_transactions_bulk`: Bulk update 1–500 transactions - `delete_transactions_bulk`: Bulk delete 1–500 transactions by ID - `create_transaction_group`: Create a transaction group from existing transactions - `delete_transaction_group`: Ungroup a transaction group - `split_transaction`: Split a transaction into 2–500 children - `unsplit_transaction`: Undo a previous split - `attach_file_to_transaction`: Upload a local file (jpeg/png/heic/heif/pdf, ≤10MB), type verified from its contents - `get_transaction_attachment_url`: Get a signed download URL for a file attachment - `delete_transaction_attachment`: Delete a file attachment - `get_recurring_items`: List recurring items for a date range (includesuggested for system suggestions) - `get_single_recurring_item`: Get a recurring item by ID - `get_budget_summary`: Per-category budget summary (backed by /summary); supports occurrences, totals, rollover-pool toggles - `get_budget_settings`: Account-wide budget period and display settings - `upsert_budget`: Create or update a budget for a category and period - `remove_budget`: Remove a budget for a category and period - `get_all_manual_accounts`: List all manually-managed accounts (formerly "assets") - `get_single_manual_account`: Get a manual account by ID - `create_manual_account`: Create a new manually-managed account - `update_manual_account`: Update properties of a manual account - `delete_manual_account`: Delete a manual account; optionally also delete its transactions / balance history - `get_all_plaid_accounts`: List all connected Plaid accounts - `get_single_plaid_account`: Get a Plaid account by ID - `trigger_plaid_fetch`: Trigger fetch of latest data from Plaid (optionally scoped to a date range or account) - `get_supported_cryptocurrencies`: List the cryptocurrencies supported for manual tracking ## Similar MCP servers - [CCXT](https://appsgit.com/mcp-servers/ccxt): Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets. (44,271 stars, MIT, official) - [Finance Toolkit](https://appsgit.com/mcp-servers/finance-toolkit): 200+ transparent financial metrics calculated from raw statements, not third-party endpoints. (5,402 stars, MIT, needs API key) - [Tradingview MCP](https://appsgit.com/mcp-servers/tradingview-mcp): Real-time market data, screeners, technical analysis & backtesting for stocks, crypto and forex. (4,948 stars, MIT) - [EdgarTools](https://appsgit.com/mcp-servers/edgartools): Open-source SEC EDGAR toolkit — 13 tools, 7 prompts, every filing type. (2,776 stars, MIT) - [AI](https://appsgit.com/mcp-servers/ai): MCP server integrating with Stripe - tools for customers, products, payments, and more. (1,859 stars, MIT, official) - [Tradememory Protocol](https://appsgit.com/mcp-servers/tradememory-protocol): Tamper-evident decision audit trail and outcome-weighted memory for AI trading agents. (1,425 stars, MIT) --- Canonical page: https://appsgit.com/mcp-servers/lunch-money Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly. Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.