MCP server for managing LunchMoney personal finances: transactions, budgets, categories, and more.
MCP server for managing LunchMoney personal finances: transactions, budgets, categories, and more.
Valid MCP server (3 strong, 1 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (5/5 approved).
4 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: LUNCHMONEY_API_TOKEN
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-akutishevsky-lunchmoney-mcp": {
"env": {
"LUNCHMONEY_API_TOKEN": "your-lunchmoney-api-token-here"
},
"args": [
"-y",
"@akutishevsky/lunchmoney-mcp"
],
"command": "npx"
}
}
}From the project's GitHub README.
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.
Heads up — v2.0.0 is a breaking release. This server now targets LunchMoney's v2 API (
https://api.lunchmoney.dev/v2, currently in alpha). It is not backwards-compatible with v1.x of this server: tool names, fields, and endpoint shapes have changed (for example,assetsis nowmanual_accounts,tagsarrays are nowtag_ids, transactionasset_idis nowmanual_account_id, thedebit_as_negativetoggle is gone, and the budget summary moved to a new/summaryendpoint). See CHANGELOG.md for the full list. If you depend on v1.x, pin@akutishevsky/lunchmoney-mcp@^1.4.3.
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.
type=cryptocurrency)The easiest way to install this server is as an MCP Bundle in Claude Desktop:
.mcpb file from the releases page.mcpb fileAdd the LunchMoney MCP server to Claude Code:
claude mcp add --transport stdio --env LUNCHMONEY_API_TOKEN=your-api-token-here lunchmoney -- npx -y @akutishevsky/lunchmoney-mcp
To enable debug logging:
claude mcp add --transport stdio --env LUNCHMONEY_API_TOKEN=your-api-token-here --env LUNCHMONEY_DEBUG=true lunchmoney -- npx -y @akutishevsky/lunchmoney-mcp
Verify the server was added:
claude mcp list
claude mcp get lunchmoney
Add the LunchMoney MCP server to Codex:
codex mcp add lunchmoney --env LUNCHMONEY_API_TOKEN=your-api-token-here -- npx -y @akutishevsky/lunchmoney-mcp
To enable debug logging:
codex mcp add lunchmoney --env LUNCHMONEY_API_TOKEN=your-api-token-here --env LUNCHMONEY_DEBUG=true -- npx -y @akutishevsky/lunchmoney-mcp
Verify the server was added:
codex mcp list
codex mcp get lunchmoney
To use this MCP server with any MCP-compatible client (such as Claude Desktop), you need to add it to the client's configuration.
The server can be configured in your MCP client's configuration file. The exact location and format may vary by client, but typically follows this pattern:
{
"mcpServers": {
"lunchmoney": {
"command": "npx",
"args": ["@akutishevsky/lunchmoney-mcp"],
"env": {
"LUNCHMONEY_API_TOKEN": "your-api-token-here",
"LUNCHMONEY_DEBUG": "true"
}
}
}
}
Note:
LUNCHMONEY_DEBUGis optional. Set it to"true"to enable debug logging of API requests and responses to stderr. Useful for troubleshooting.
Replace "your-api-token-here" with your actual LunchMoney API token from LunchMoney Developer Settings.
Different MCP clients store their configuration in different locations:
Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/Claude/claude_desktop_config.jsonOther MCP Clients: Check your client's documentation for the configuration file location.
mcpServers section.npx available in your system PATH# Run with npx
LUNCHMONEY_API_TOKEN="your-api-token" npx @akutishevsky/lunchmoney-mcp
Here are some example prompts you can use with the LunchMoney MCP server:
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)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 callupdate_transaction - Partial update of one transactiondelete_transaction - Delete one transaction (cannot be split/group)update_transactions_bulk - Bulk update 1–500 transactionsdelete_transactions_bulk - Bulk delete 1–500 transactions by IDcreate_transaction_group - Create a transaction group from existing transactionsdelete_transaction_group - Ungroup a transaction groupsplit_transaction - Split a transaction into 2–500 childrenunsplit_transaction - Undo a previous splitattach_file_to_transaction - Upload a local file (jpeg/png/heic/heif/pdf, ≤10MB)get_transaction_attachment_url - Get a signed download URL for a file attachmentdelete_transaction_attachment - Delete a file attachmentget_recurring_items - List recurring items for a date range (include_suggested for system suggestions)get_single_recurring_item - Get a recurring item by IDget_budget_summary - Per-category budget summary (backed by /summary); supports occurrences, totals, rollover-pool togglesget_budget_settings - Account-wide budget period and display settingsupsert_budget - Create or update a budget for a category and periodremove_budget - Remove a budget for a category and periodget_all_manual_accounts - List all manually-managed accounts (formerly "assets")get_single_manual_account - Get a manual account by IDcreate_manual_account - Create a new manually-managed accountupdate_manual_account - Update properties of a manual accountdelete_manual_account - Delete a manual account; optionally also delete its transactions / balance historyget_all_plaid_accounts - List all connected Plaid accountsget_single_plaid_account - Get a Plaid account by IDtrigger_plaid_fetch - Trigger fetch of latest data from Plaid (optionally scoped to a date range or account)get_all_crypto - List cryptocurrency holdings (filters /manual_accounts to type=cryptocurrency)update_manual_crypto - Update the balance of a manually-managed cryptocurrency accountlunchmoney-mcp/
├── src/
│ ├── index.ts # Server entry point
│ ├── config.ts # Configuration management
│ ├── types.ts # TypeScript type definitions
│ └── tools/ # Tool implementations
│ ├── user.ts
│ ├── categories.ts
│ ├── tags.ts
│ ├── transactions.ts
│ ├── recurring-items.ts
│ ├── budgets.ts
│ ├── manual-accounts.ts
│ ├── plaid-accounts.ts
│ └── crypto.ts
├── build/ # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md
# Build the MCP server
npm run build
# Build MCPB package for distribution
npm run build:mcpb
src/tools/src/index.tssrc/types.ts if neededThe server implements the full LunchMoney API v2. For detailed API documentation, see:
Contributions are welcome! Please feel free to submit a Pull Request.
MIT License
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
by mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.