Lunch Money MCP Server
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. Its 40 documented tools cover transaction, single, manual, account. It runs locally over stdio via the published package.
People connecting API integration tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.
VERIFIED ACTIVE
LAST COMMIT 2026-08-03 · ★ 95 · #13 OF 250 MAINTAINED API INTEGRATION · VERIFIED 2026-08-25
MIT · TypeScript servers · how we verify → /methodology
01 · Install Lunch Money
before you install - you'll need
Set LUNCHMONEY_API_TOKEN before connecting. LUNCHMONEY_DEBUG is optional or environment-specific per the README.
Claude Code
claude mcp add akutishevsky-lunchmoney-mcp -- npx -y @akutishevsky/lunchmoney-mcpClaude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"akutishevsky-lunchmoney-mcp": {
"command": "npx",
"args": [
"-y",
"@akutishevsky/lunchmoney-mcp"
]
}
}
}Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.
Using another client? Same JSON, different key
Claude Desktop · mcpServers
Cursor · mcpServers
VS Code · servers
Windsurf · mcpServers
Zed · context_servers
Cline · mcpServers
Roo Code · mcpServers
Continue · mcpServers
LibreChat · mcpServers
Gemini CLI · mcpServers
Codex CLI · mcp_servers
Full setup guides: every client.
02 · Evidence
Security posture
What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.
runs as local process (stdio) - runs on your machine with your user's permissions
license MIT - declared in the repository
npm package @akutishevsky/lunchmoney-mcp - published under the repo owner's npm scope (@akutishevsky)
registry namespace io.github.akutishevsky is GitHub-verified and matches the repo owner
03 · What Lunch Money can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
What you can build
With this server connected, an agent can retrieve current user details, list all categories (supports format and is_group filters), get details for a specific category or category group, and create a category or category group (set is_group=true plus children).
Capability map
Tools grouped from the project's README - what Lunch Money lets an agent do.
Transaction
9 tools - e.g. Partial update of one transaction; Delete one transaction (cannot be split/group); Create a transaction group from existing transactions
update_transaction · delete_transaction · create_transaction_group · delete_transaction_group · split_transaction · unsplit_transaction…
Single
6 tools - e.g. Get details for a specific category or category group; Get a tag by ID; Get full transaction details (always includes plaid_metadata, custom_metadata, files, and children for split/group parents)
get_single_category · get_single_tag · get_single_transaction · get_single_recurring_item · get_single_manual_account · get_single_plaid_account
read & search
5 tools - e.g. Retrieve current user details; List all categories (supports format and is_group filters); List all tags
get_user · get_all_categories · get_all_tags · get_recurring_items · get_supported_cryptocurrencies
Transactions
4 tools - e.g. List transactions with extensive filtering options (date range, account, category, tag, status, pending, metadata, files, etc); Insert 1–500 transactions in one call; Bulk update 1–500 transactions
get_transactions · create_transactions · update_transactions_bulk · delete_transactions_bulk
Budget
4 tools - e.g. Per-category budget summary (backed by /summary); supports occurrences, totals, rollover-pool toggles; Account-wide budget period and display settings; Create or update a budget for a category and period
get_budget_summary · get_budget_settings · upsert_budget · remove_budget
Manual
4 tools - e.g. List all manually-managed accounts (formerly "assets"); Create a new manually-managed account; Update properties of a manual account
get_all_manual_accounts · create_manual_account · update_manual_account · delete_manual_account
Category
3 tools - e.g. Create a category or category group (set is_group=true plus children); Update properties; replaces the children list on category groups; Delete a category; pass force=true to override dependency check
create_category · update_category · delete_category
Tag
3 tools - e.g. Create a new tag; Update tag properties; Delete a tag (with force to override dependents)
create_tag · update_tag · delete_tag
Latest releases
mcpb-3.0.0 · 2026-08-03
[3.0.0] - 2026-08-03 · Breaking change, scoped to the crypto tools. Crypto was the last domain still calling LunchMoney's v1 API; this release moves it to v2, so the server no longer talks to dev.lunchmoney.app/v1 at…
mcpb-2.2.0 · 2026-08-01
[2.2.0] - 2026-08-01 · Security · attach_file_to_transaction no longer reads arbitrary files (#16). The tool passed the caller-supplied file_path straight to readFile with no confinement, and its MIME allow-list…
mcpb-2.1.1 · 2026-05-31
[2.1.1] - 2026-05-31 · Fixed · TOON formatting now properly compacts arrays of objects by dropping keys that are blank in every row while preserving partially-present keys as explicit nulls, ensuring uniform structure…
04 · Who maintains Lunch Money
Lunch Money is maintained by akutishevsky. We track 5 MCP servers from akutishevsky - 4 actively maintained, 188 combined GitHub stars, oldest repo from Jul 2025. Full record: all servers from akutishevsky.
- Monobank MCP server for Monobank API - currency rates, client info, and account statements ★ 7
- Nutrition MCP Personal nutrition tracking - log meals, track macros, review history, import from another app. ★ 47
- Withings Health Data MCP server for Withings health data - sleep, activity, heart, and body metrics. ★ 39
05 · Facts
- repository
- github.com/akutishevsky/lunchmoney-mcp
- category
- API integration - ranked #13 of 250 actively-maintained API integration servers as of 2026-08-25.
- release cadence
- 3 releases in the last 90 days (latest 2026-08-03)
- registry
- io.github.akutishevsky/lunchmoney-mcp (active, first published 2026-02-17 · 3 versions)
- packages
- npm:@akutishevsky/lunchmoney-mcp
06 · Lunch Money FAQ
Is Lunch Money still maintained?
Yes - as of 2026-08-25, its last commit was 2026-08-03 and it shipped 3 releases in the last 90 days. We re-verify nightly.
What can Lunch Money do?
With this server connected, an agent can retrieve current user details, list all categories (supports format and is_group filters), get details for a specific category or category group, and create a category or category group (set is_group=true plus children).
How do I install Lunch Money?
Run `npx -y @akutishevsky/lunchmoney-mcp`. The README documents 2 environment variables (LUNCHMONEY_API_TOKEN, LUNCHMONEY_DEBUG) to set first. Set LUNCHMONEY_API_TOKEN before connecting. LUNCHMONEY_DEBUG is optional or environment-specific per the README. You can also paste the ready-made client config above.
Does Lunch Money run locally?
Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.
07 · Alternatives to Lunch Money
Alternatives to Lunch Money
Maintained API integration servers if Lunch Money isn't the fit.
- Microsoft 365 MCP Server Interact with Microsoft 365 and Office services through the Microsoft Graph API. ★ 932 · 2026-08-24
- Tapo MCP MCP server for discovering and controlling TP-Link Tapo smart home devices via AI Agents ★ 796 · 2026-08-21
- Idea Reality MCP Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt - returns 0-100 signal. ★ 782 · 2026-08-11
- Sqz Pre-injection context compression for coding agents. Zero LLM calls, zero telemetry, offline-safe. ★ 609 · 2026-08-23
- Sv Number MCP Server Phone numbers for AI agents: order a private number, read the SMS verification code, hand it back. ★ 560 · 2026-08-10
- Anytype MCP Official MCP server for Anytype API - your encrypted, local and collaborative wiki. ★ 510 · 2026-08-24
More API integration MCP servers · Monobank · Revettr MCP · Kotlin & Java Library Sources · Apiverve
More TypeScript MCP servers · Withings Health Data · Web Validator by DigestSEO · Emails · Campus CLI · see all