akutishevsky/lunchmoney-mcp

Download latest .mcpb from releases and install as an Extension in Claude Desktop
claude mcp add lunchmoney --transport stdio -e LUNCHMONEY_API_TOKEN=your-api-token-here -- npx -y @akutishevsky/lunchmoney-mcp
codex mcp add lunchmoney --env LUNCHMONEY_API_TOKEN=your-api-token-here -- npx -y @akutishevsky/lunchmoney-mcp

Usage

• •"Show me all transactions from last month"
• •"Show me my budget summary for this month"
• •"What are my top spending categories this month?"
• •"Refresh my bank account data"

Key features

• ✓Full coverage of categories, tags, transactions, recurring items, budgets, manual accounts, Plaid accounts, crypto, and balance history
• ✓Bulk transaction create/update/delete (up to 500) and splits/groups
• ✓Token-efficient responses using TOON encoding instead of JSON
• ✓Type-safe with TypeScript and Zod validation
• ✓Embeddable as a library for custom HTTP transports (e.g. self-hosted StreamableHTTPServerTransport with Express/Hono/Fastify)
• ✓Turnkey Cloudflare Workers deployment (lunchmoney-mcp-cloudflare)

Best for

LunchMoney users who want to manage budgets, transactions, and net worth through Claude or other AI assistants

Caveats

• ⚠Targets LunchMoney API v2 (alpha); v2.0.0+ is not backwards-compatible with v1.x tool names
• ⚠v3.0.0 removed get_all_crypto (use get_all_manual_crypto + get_all_synced_crypto)
• ⚠Config is a single-tenant singleton; not safe for shared-process multi-tenant hosts
• ⚠Requires a LunchMoney API token (LUNCHMONEY_API_TOKEN)
• ⚠attach_file_to_transaction reads files from the filesystem; set LUNCHMONEY_ATTACHMENTS_DIR on remote deployments