Lunch Money

io.github.akutishevsky由 GitHub 帳號 akutishevsky 發布v4.0.1更新於 Nov 8, 2026

MCP server for managing LunchMoney personal finances: transactions, budgets, categories, and more.

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

本機 MCP 伺服器,讓助理讀取並管理 LunchMoney 個人財務:交易、預算、分類、標籤、帳戶、加密貨幣與餘額歷史。

可以做什麼
  • 讀取並更新使用者、帳戶及使用者帳戶設定
  • 建立、更新與刪除分類、分類群組和標籤
  • 查詢、建立、更新、批次修改、刪除交易,並支援拆分、分組與附加收據
  • 檢視週期性項目與各分類預算彙總,並新增或移除預算
  • 管理手動帳戶、Plaid 連結帳戶與加密貨幣帳戶,以及每月餘額歷史
適用情境
適合在 LunchMoney 記帳與編列預算、希望助理在對話中直接查看支出、整理交易分類、調整預算或核對淨資產的情境。
執行需求
透過 npx 以 stdio 在本機執行,需要 Node.js 16+ 與 npx。必須在 LUNCHMONEY_API_TOKEN 環境變數提供 LunchMoney API 權杖;LUNCHMONEY_DEBUG 與 LUNCHMONEY_ATTACHMENTS_DIR 為選用。需要可連線至 LunchMoney v2 API 的網路。
安裝前請注意
此 API 權杖可存取你的財務資料,請勿寫入共用設定。許多工具會寫入或刪除資料,分類、標籤、交易與附件的強制刪除無法復原。上傳收據會讀取本機檔案,建議設定 LUNCHMONEY_ATTACHMENTS_DIR 限制範圍,遠端部署時尤其重要。除錯記錄會把 API 請求與回應寫入 stderr。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Lunch Money,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

LunchMoney MCP Server

[npm version] [npm downloads] [GitHub downloads] [license] [TypeScript] [MCP Badge]

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 — v4.0.1 validates inputs against the LunchMoney v2 spec. Tool names and parameters are unchanged, and six settings tools are added. Inputs the API would reject are now refused before any request is sent: unknown currency codes, null or empty amounts, unpaired date ranges, updates with no fields, and conflicting fields such as manual_account_id with plaid_account_id. delete_tag and delete_category now report a 422 as an error, and a split child with category_id: null is sent as uncategorized instead of 0. See CHANGELOG.md for the full list. If you depend on the old behaviour, pin @akutishevsky/lunchmoney-mcp@^3.0.0.

Heads up — v3.0.0 removes get_all_crypto. The crypto tools now use LunchMoney's v2 crypto endpoints, which split manual and synced holdings into separate resources and offer no combined equivalent of v1's GET /crypto. Replace get_all_crypto with get_all_manual_crypto and get_all_synced_crypto, which together return everything it did and more. update_manual_crypto also drops its currency parameter. Nothing outside the crypto domain changed; if you don't use the crypto tools, upgrading from 2.x needs no action. See CHANGELOG.md. If you depend on get_all_crypto, pin @akutishevsky/lunchmoney-mcp@^2.2.0.

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, assets is now manual_accounts, tags arrays are now tag_ids, transaction asset_id is now manual_account_id, the debit_as_negative toggle is gone, and the budget summary moved to a new /summary endpoint). See CHANGELOG.md for the full list. If you depend on v1.x, pin @akutishevsky/lunchmoney-mcp@^1.4.3.

[LunchMoney Server MCP server]

Table of Contents

Overview

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.

Features

Comprehensive Tool Coverage

  • User Management - Access user account details
  • Categories - Full CRUD on categories and category groups
  • Tags - Full CRUD for transaction tags
  • Transactions - Full CRUD with advanced filtering, bulk update, bulk delete, splits, groups, and file attachments
  • Recurring Items - Track and manage recurring expenses, including system-suggested items
  • Budgets - Per-period budget summary, account-wide budget settings, upsert, and delete
  • Manual Accounts - Full CRUD for manually-managed accounts (formerly known as "assets")
  • Plaid Accounts - List, retrieve, and trigger sync of connected bank accounts
  • Cryptocurrency - Full CRUD for manual crypto balances, read and refresh synced crypto accounts, and manage the supported-cryptocurrency list
  • Balance History - Read, upsert, and delete monthly balance history for manual, Plaid, crypto, and deleted accounts

Key Capabilities

  • Full integration with LunchMoney API v2 (alpha)
  • Type-safe implementation with TypeScript and Zod validation
  • Token-efficient responses using TOON encoding instead of JSON, reducing token usage in AI conversations
  • Modular architecture for easy extension
  • Standard MCP server implementation using stdio transport

Usage

Installation Options

MCP Bundle (.mcpb) - Recommended

The easiest way to install this server is as an MCP Bundle in Claude Desktop:

  1. Download the latest .mcpb file from the releases page
  2. Open Claude Desktop and go to Extensions
  3. Click "Install Extension" and select the downloaded .mcpb file
  4. Enter your LunchMoney API token when prompted (get it from LunchMoney Developer Settings)
  5. The LunchMoney tools will be immediately available

Claude Code CLI

Add the LunchMoney MCP server to Claude Code:

bash
claude mcp add lunchmoney --transport stdio -e LUNCHMONEY_API_TOKEN=your-api-token-here -- npx -y @akutishevsky/lunchmoney-mcp

To enable debug logging:

bash
claude mcp add lunchmoney --transport stdio -e LUNCHMONEY_API_TOKEN=your-api-token-here -e LUNCHMONEY_DEBUG=true -- npx -y @akutishevsky/lunchmoney-mcp

Verify the server was added:

bash
claude mcp listclaude mcp get lunchmoney

Codex CLI

Add the LunchMoney MCP server to Codex:

bash
codex mcp add lunchmoney --env LUNCHMONEY_API_TOKEN=your-api-token-here -- npx -y @akutishevsky/lunchmoney-mcp

To enable debug logging:

bash
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:

bash
codex mcp listcodex mcp get lunchmoney

Manual MCP Configuration

To use this MCP server with any MCP-compatible client (such as Claude Desktop), you need to add it to the client's configuration.

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:

json
{    "mcpServers": {        "lunchmoney": {            "command": "npx",            "args": ["@akutishevsky/lunchmoney-mcp"],            "env": {                "LUNCHMONEY_API_TOKEN": "your-api-token-here",                "LUNCHMONEY_DEBUG": "true"            }        }    }}

Note: LUNCHMONEY_DEBUG is optional. Set it to "true" to enable debug logging of API requests and responses to stderr. Useful for troubleshooting.

Note: LUNCHMONEY_ATTACHMENTS_DIR is optional. attach_file_to_transaction is the only tool that reads from your filesystem, and it always verifies that a file really is a JPEG, PNG, HEIC, HEIF, or PDF before uploading it. Set this variable to a directory (say, a ~/Receipts folder) to additionally restrict it to files inside that directory — .. and symlinks that point outside are rejected. Leave it unset and any path the server can read is fair game, which is usually fine for a local stdio server but not for remote deployments.

Replace "your-api-token-here" with your actual LunchMoney API token from LunchMoney Developer Settings.

Common MCP Client Configuration Locations

Different MCP clients store their configuration in different locations:

  • Claude Desktop:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json
  • Other MCP Clients: Check your client's documentation for the configuration file location.

Setup Steps
  1. Locate your MCP client's configuration file (create it if it doesn't exist).
  2. Add the LunchMoney server configuration to the mcpServers section.
  3. Save the file and restart your MCP client.
  4. The LunchMoney tools should now be available in your client.
Requirements
  • Node.js 16+ installed on your system
  • npx available in your system PATH
  • Valid LunchMoney API token with appropriate permissions

Standalone Server

bash
# Run with npxLUNCHMONEY_API_TOKEN="your-api-token" npx @akutishevsky/lunchmoney-mcp

Remote Deployments

The bundled stdio binary covers desktop MCP clients, but Claude on mobile and the custom connectors feature in claude.ai only speak HTTP. There are two ways to expose this server remotely.

Turnkey: Cloudflare Workers

lunchmoney-mcp-cloudflare wraps this package as a Cloudflare Worker with Google sign-in and an email allowlist in front of the MCP endpoint. The whole stack fits inside Cloudflare's and Google Cloud's free tiers, and a setup.sh wizard handles KV creation, OAuth client setup, secrets, and deploy in one walkthrough. Each authenticated user runs in their own Durable Object, so the config singleton stays per-user.

Self-hosted: HTTP transport on your own host

For a single-user deployment, wire createServer() into StreamableHTTPServerTransport and serve it from any Node HTTP framework. Example with Express:

ts
import express from "express";import { createServer } from "@akutishevsky/lunchmoney-mcp/server";import { initializeConfig } from "@akutishevsky/lunchmoney-mcp/config";import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
initializeConfig(process.env.LUNCHMONEY_API_TOKEN!);const server = createServer("1.0.0");
const transport = new StreamableHTTPServerTransport({    sessionIdGenerator: () => crypto.randomUUID(),});await server.connect(transport);
const app = express();app.use(express.json());app.all("/mcp", (req, res) => transport.handleRequest(req, res, req.body));app.listen(3000);

Swap Express for Hono (via @hono/node-server) or Fastify if you prefer — the transport only needs Node's IncomingMessage and ServerResponse. Add your own auth in front of /mcp — the package ships no transport-level auth.

Set LUNCHMONEY_ATTACHMENTS_DIR on any remote deployment. attach_file_to_transaction reads a path supplied by the caller off the host's filesystem. On a desktop stdio server the caller and the file owner are the same person, so that is unremarkable. Once the server is reachable over HTTP they are different principals, and an unconfined read is a way for a remote caller — or a prompt-injected model — to pull files off your host. Point the variable at a dedicated directory and keep nothing else in it. The content-type check (only real JPEG/PNG/HEIC/HEIF/PDF files upload) applies either way, but it is a backstop, not a substitute.

Multi-tenant warning. This pattern serves one user from one process with one shared API token. To serve multiple users from a single Node process you'd hit the single-tenant config singleton; fork the process per user or use the Cloudflare option above (each user gets their own isolate).

Example Prompts

Here are some example prompts you can use with the LunchMoney MCP server:

Account Overview

  • "Show me my LunchMoney account details"
  • "What's my current account status?"

Category Management

  • "List all my spending categories"
  • "Create a new category called 'Subscriptions' with a monthly budget of $100"
  • "Show me details for my 'Food & Dining' category"
  • "Create a category group for all my entertainment expenses"
  • "Delete the 'Unused Category' and reassign its transactions to 'Miscellaneous'"

Transaction Management

  • "Show me all transactions from last month"
  • "Find all transactions over $100 in the past week"
  • "Create a new expense for $45.99 at Amazon in the Shopping category"
  • "Update transaction #12345 to change the amount to $50"
  • "Show me all pending transactions"
  • "Group these coffee shop transactions together"

Budgeting

  • "Show me my budget summary for this month"
  • "Set a budget of $500 for Groceries this month"
  • "Remove the budget for Entertainment category"
  • "How much have I spent vs budgeted in each category?"

Manual Account Tracking

  • "List all my manual accounts"
  • "Create a new manual account for my savings account with a balance of $10,000"
  • "Update my investment account balance to $25,000"
  • "Close my old credit card account"

Recurring Expenses

  • "Show me all my recurring expenses"
  • "What subscriptions do I have?"
  • "List recurring items for the next 3 months"

Banking Integration

  • "Show me all my connected Plaid accounts"
  • "Refresh my bank account data"
  • "Trigger a sync for my checking account"

Cryptocurrency

  • "Show me all my crypto holdings"
  • "Update my Bitcoin balance to 0.5 BTC"
  • "List all my manually tracked crypto assets"
  • "Add a cold wallet holding 0.85 BTC called Ledger Cold Storage"
  • "Refresh my Coinbase account and show the updated balances"
  • "Which cryptocurrencies can I track manually?"

Net Worth & Balance History

  • "Show me how my net worth changed over the last 12 months"
  • "What was my savings account balance in March 2026?"
  • "Set my car's value to $18,000 for June 2026"
  • "Clear the balance history for my old brokerage account"

Analysis & Insights

  • "What are my top spending categories this month?"
  • "Show me all transactions tagged as 'vacation'"
  • "Find all transactions at coffee shops"
  • "List all transactions that need to be categorized"

Available Tools

User Tools

  • get_user - Retrieve current user details
  • get_account_settings - Get account-wide settings (currencies, locale, display name, rule automation)
  • update_account_settings - Update account-wide settings (at least one field required)
  • get_user_settings - Get user-wide display and formatting preferences
  • update_user_settings - Update user-wide display and formatting preferences (at least one field required)
  • get_user_account_settings - Get user-specific settings within the budget account
  • update_user_account_settings - Update user-specific account settings, such as the default manual account (at least one field required)

Category Tools

  • get_all_categories - List all categories (supports format and is_group filters)
  • get_single_category - Get details for a specific category or category group
  • create_category - Create a category or category group (set is_group=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

Tag Tools

  • 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)

Transaction Tools

  • 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 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

Recurring Items Tools

  • get_recurring_items - List recurring items for a date range (include_suggested for system suggestions)
  • get_single_recurring_item - Get a recurring item by ID

Budget Tools

  • 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

Manual Account Tools

  • 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

Plaid Account Tools

  • 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)

Crypto Tools

  • get_supported_cryptocurrencies - List the cryptocurrencies supported for manual tracking (optional search filter)
  • add_supported_cryptocurrency - Add a cryptocurrency to the supported list from its CoinGecko coin-page URL
  • get_all_manual_crypto - List all manually-managed crypto balances
  • get_single_manual_crypto - Get a single manually-managed crypto balance by ID
  • create_manual_crypto - Create a manually-managed crypto asset
  • update_manual_crypto - Update a manual crypto balance's name, display name, institution name, or balance
  • delete_manual_crypto - Delete a manual crypto asset (irreversible)
  • get_all_synced_crypto - List synced crypto accounts and their nested per-symbol balances
  • get_single_synced_crypto - Get a single synced crypto account by ID
  • get_synced_crypto_balance - Get one balance inside a synced crypto account by symbol
  • refresh_synced_crypto - Trigger a balance refresh for a synced crypto account

Balance History Tools

  • get_balance_history - Get monthly balance history across all accounts (powers the Net Worth views); optional start_month/end_month (YYYY-MM) range filter
  • get_account_balance_history - Get monthly balance history for one account (manual, plaid, crypto_manual, or deleted)
  • upsert_account_balance_history - Create or update monthly balance entries for one account (past months only; all-or-nothing)
  • delete_account_balance_history - Delete all historical balance entries for one account
  • get_crypto_synced_balance_history - Get monthly balance history for a synced crypto holding by account id + ticker symbol
  • upsert_crypto_synced_balance_history - Create or update monthly balance entries for a synced crypto holding
  • delete_crypto_synced_balance_history - Delete all historical balance entries for a synced crypto holding
  • delete_balance_history_entry - Delete a single historical balance entry by id
  • update_deleted_account_details - Update the display details (name, institution, type, subtype, mask) shown for a deleted account's balance history

Development

Project Structure

lunchmoney-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│       └── balance-history.ts├── build/                 # Compiled JavaScript output├── package.json├── tsconfig.json└── README.md

Building

bash
# Build the MCP servernpm run build
# Build MCPB package for distributionnpm run build:mcpb

Adding New Tools

  1. Create a new file in src/tools/
  2. Implement tool handlers using the MCP SDK
  3. Register tools in src/index.ts
  4. Add types to src/types.ts if needed

Embedding as a library

The package exposes subpath entry points so it can be embedded in a custom transport (for example, a Cloudflare Worker that serves the MCP protocol over HTTP) rather than only the bundled stdio binary:

ts
import { createServer } from "@akutishevsky/lunchmoney-mcp/server";import { initializeConfig } from "@akutishevsky/lunchmoney-mcp/config";
initializeConfig(process.env.LUNCHMONEY_API_TOKEN!);const server = createServer("1.0.0");// connect `server` to whatever transport you need

initializeConfig must be called before any tool is invoked, or the first request throws "Configuration not initialized.".

Single-tenant assumption. The config is held in a module-level singleton. That is safe on per-isolate runtimes — each user gets their own isolate, so there is no shared mutable state to race on. It is not safe on shared-process multi-tenant Node hosts (e.g. one Express or Hono process serving multiple users): concurrent initializeConfig calls would race and leak tokens between requests. Those consumers need to fork per-user or refactor the singleton before exposing the package.

API Reference

The server implements the full LunchMoney API v2. For detailed API documentation, see:

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License

來源:README.md,提交 6013953

工具

65

get_user

Get details on the current user

無需輸入參數。

get_account_settings

Get account-wide settings for the current budget account: primary and supported currencies, display name, locale, and rule/totals preferences. These apply regardless of which user accesses the account.

無需輸入參數。

update_account_settings

Update account-wide settings for the current budget account. At least one field must be provided; omitted fields are left unchanged. Returns the full account settings.

輸入參數localedisplay_nameprimary_currencysupported_currenciesinclude_pending_in_totalsauto_create_category_rulesauto_create_suggested_transaction_rules

get_user_settings

Get user-wide display and formatting preferences for the authorized user: debit sign display, payee suggestions, date and time formats, week start, and year/weekday display. These apply across every budget account the user can access.

無需輸入參數。

update_user_settings

Update user-wide display and formatting preferences for the authorized user. At least one field must be provided; omitted fields are left unchanged. show_debits_as_negative only changes display in the Lunch Money app: amounts in API responses always use positive values for debits and negative values for credits. Returns the full user settings.

輸入參數show_am_pmweek_starts_onmonth_day_formatmonth_year_formatauto_suggest_payeealways_display_yearmonth_day_year_formatalways_display_weekdayshow_debits_as_negative

get_user_account_settings

Get settings specific to the authorized user within the current budget account: transaction review behavior and the default manual account for new manual transactions. These do not affect other users or the user's settings in other budget accounts.

無需輸入參數。

update_user_account_settings

Update settings specific to the authorized user within the current budget account. At least one field must be provided; omitted fields are left unchanged. Returns the full user account settings.

輸入參數default_manual_account_idauto_review_transaction_on_updateauto_review_transaction_on_creation

get_all_categories

Get a list of all categories associated with the user's account. Categories are sorted by their order; categories without an order are listed alphabetically after those that have one.

輸入參數formatis_group

get_single_category

Get details on a single category or category group, including the list of children categories for category groups.

輸入參數categoryId必填

create_category

Create a new category or a category group. Set is_group=true to create a category group; supply children as an array of existing category IDs, existing category objects, and/or strings (names of new sub-categories to create).

輸入參數name必填orderarchivedchildrengroup_idis_groupcollapsedis_incomedescriptionexclude_from_budgetexclude_from_totals

update_category

Update properties for an existing category or category group. Provide at least one updatable property. For category groups, supplying children replaces the group's full child list. Cannot be used to convert between category and category group.

輸入參數namearchivedchildrengroup_idis_groupcollapsedis_incomecategoryId必填archived_atdescriptionexclude_from_budgetexclude_from_totals

delete_category

Delete a single category or category group. By default fails (HTTP 422) if dependencies exist, returning a structured `dependents` payload. Set force=true to delete and disassociate from all related budgets, transactions, recurring items, etc. Force delete is irreversible.

輸入參數forcecategory_id必填

get_all_tags

Get a list of all tags associated with the user's account.

無需輸入參數。

get_single_tag

Get details of a single tag by ID.

輸入參數tagId必填

create_tag

Create a new tag.

輸入參數name必填archivedtext_colordescriptionbackground_color

update_tag

Update properties for an existing tag. Only the fields provided are changed; at least one field must be provided.

輸入參數nametagId必填archivedtext_colorarchived_atdescriptionbackground_color

delete_tag

Delete a tag. By default the deletion is refused if the tag is in use by transactions or rules: the result is an error containing a `dependents` payload listing the rules and transactions that still reference the tag. Set force=true to delete the tag and disassociate it from those records (irreversible).

輸入參數forcetagId必填

get_transactions

Retrieve transactions, optionally filtered by date range, account, category, tag, recurring item, status, and more. Returns at most `limit` transactions (default 1000, max 2000); `has_more` is set on the response when more match the filters. Pending and split-parent / group-child transactions are excluded by default.

輸入參數limitoffsetstatustag_idend_dateis_pendingstart_datecategory_idrecurring_idcreated_sinceinclude_filesupdated_since另有 8 個

get_single_transaction

Get details of a specific transaction. The response always includes plaid_metadata, custom_metadata, files, and (for split or group parents) the children array — none of which are returned by default in get_transactions.

輸入參數transaction_id必填

create_transactions

Insert one or more transactions (1-500 per call). Returns inserted transactions plus any skipped duplicates.

輸入參數apply_rulestransactions必填skip_duplicatesskip_balance_update

update_transaction

Update an existing transaction. Provide any subset of writable fields directly (the v2 API no longer wraps the body in a `transaction` envelope). Cannot modify split or grouped transactions; use the corresponding split/group tools instead.

輸入參數update必填transaction_id必填update_balance

delete_transaction

Delete a single transaction. Fails for split/group transactions and their parents — unsplit/ungroup first. Irreversible.

輸入參數transaction_id必填

update_transactions_bulk

Update multiple transactions in a single call (1-500). Each entry must include `id` plus at least one writable field. Cannot be used to modify split or grouped transactions.

輸入參數transactions必填

delete_transactions_bulk

Bulk-delete transactions by ID (1-500). Fails if any ID is a split or group parent, or part of a split/group; unsplit or ungroup those first. Irreversible.

輸入參數ids必填

create_transaction_group

Create a transaction group from 2-500 existing transactions. Source transactions are hidden from get_transactions; the new group's `children` are returned by get_single_transaction on the group's ID. Cannot include split or recurring transactions, and transactions that are already grouped must be ungrouped (delete_transaction_group) before being regrouped.

輸入參數ids必填date必填notespayee必填statustag_idscategory_id

delete_transaction_group

Delete (ungroup) a transaction group. The original child transactions remain and revert to normal ungrouped transactions.

輸入參數transaction_id必填

split_transaction

Split an existing transaction into 2-500 child transactions. The sum of child amounts must equal the parent's amount. After splitting, the parent is hidden from get_transactions and accessible via get_single_transaction (returns the parent with `children`).

輸入參數transaction_id必填child_transactions必填

unsplit_transaction

Unsplit a previously split transaction by deleting its children and restoring the parent. Pass the parent (split_parent_id) — not a child — as the path id.

輸入參數transaction_id必填

attach_file_to_transaction

Attach a local image or PDF receipt (max 10MB) to a transaction. Allowed types: image/jpeg, image/png, image/heic, image/heif, application/pdf. The file is read from the local filesystem of the host running this MCP server, and its type is determined from its actual contents — files that are not a real image or PDF are rejected. If LUNCHMONEY_ATTACHMENTS_DIR is set on the host, only files inside that directory can be attached.

輸入參數notesfile_path必填content_typetransaction_id必填

get_transaction_attachment_url

Get a short-lived signed download URL for a transaction file attachment. The response includes the URL and an `expires_at` timestamp.

輸入參數file_id必填

delete_transaction_attachment

Delete a transaction file attachment. Irreversible.

輸入參數file_id必填

get_recurring_items

Retrieve a list of recurring items expected for a specified date range. The `matches` object on each item is populated based on the requested range and is null for suggested items.

輸入參數end_datestart_dateinclude_suggested

get_single_recurring_item

Retrieve a single recurring item by ID. Optional date range populates the `matches` object.

輸入參數end_datestart_daterecurringId必填

get_budget_summary

Get a summary of the user's budget for a specified date range. Returns per-category totals (other_activity, recurring_activity, budgeted, available, recurring_remaining, recurring_expected). Set include_occurrences=true for a per-period breakdown matching the account's budget periodicity. Ranges that do not align with budget periods return aligned=false, and categories omit the budgeted and available values. (Backed by the v2 GET /summary endpoint.)

輸入參數end_date必填start_date必填include_totalsinclude_occurrencesinclude_rollover_poolinclude_past_budget_datesinclude_exclude_from_budgets

get_budget_settings

Get budget period and display settings for the account (granularity, period quantity, anchor date, hide-no-activity preference, last-day-of-month preference, income option, rollover-left-to-budget setting). General preferences such as currency and locale are not included; they live on the account settings endpoint.

無需輸入參數。

upsert_budget

Create or update a budget for a category and budget period. The start_date must be a valid budget period start for the account (see get_budget_settings).

輸入參數notesamount必填currencystart_date必填category_id必填

remove_budget

Remove the budget for a specific category and period. The request is idempotent — succeeds even if no budget exists for the period.

輸入參數start_date必填category_id必填

get_all_manual_accounts

Get a list of all manually-managed accounts associated with the user. (Formerly known as `assets` in the v1 API.)

無需輸入參數。

get_single_manual_account

Get details of a single manual account by ID.

輸入參數accountId必填

create_manual_account

Create a new manually-managed account. (Formerly `create_asset`.)

輸入參數name必填type必填statusbalance必填subtypecurrencyclosed_onexternal_iddisplay_namebalance_as_ofcustom_metadatainstitution_name另有 1 個

update_manual_account

Update an existing manually-managed account. Provide at least one field to change. (Formerly `update_asset`.)

輸入參數nametypestatusbalancesubtypecurrencyaccountId必填closed_onexternal_iddisplay_namebalance_as_ofcustom_metadata另有 2 個

delete_manual_account

Delete a manually-managed account. Optionally also delete its transactions/rules/recurring items (irreversible), and/or its balance history.

輸入參數accountId必填delete_itemsdelete_balance_history

get_all_plaid_accounts

Get a list of all Plaid (synced) accounts associated with the user.

無需輸入參數。

get_single_plaid_account

Get details of a single Plaid (synced) account by ID.

輸入參數accountId必填

trigger_plaid_fetch

Trigger a fetch of latest data from Plaid. An account is eligible only if its last_fetch is over 1 minute ago; calling again sooner returns 425 Too Early, so use this sparingly. Optionally scope the fetch to a date range (start_date and end_date must be provided together) and/or a specific Plaid account ID. The fetch runs as a background job, so the results are not immediate.

輸入參數idend_datestart_date

get_supported_cryptocurrencies

Get the list of cryptocurrencies supported for manual tracking. The `symbol` of an entry here is what must be passed to create_manual_crypto. The full list has well over a thousand entries, so pass `search` when looking for a specific coin.

輸入參數search

add_supported_cryptocurrency

Add a new cryptocurrency to the supported manual-crypto list by submitting its CoinGecko coin-page URL. Only needed when get_supported_cryptocurrencies does not already list the symbol you want to track.

輸入參數coingecko_url必填

get_all_manual_crypto

Get all manually-managed crypto balances associated with the user.

無需輸入參數。

get_single_manual_crypto

Get a single manually-managed crypto balance by ID. Call get_all_manual_crypto first to discover ids.

輸入參數crypto_id必填

create_manual_crypto

Create a manually-managed crypto asset. The symbol must match one returned by get_supported_cryptocurrencies.

輸入參數name必填symbol必填balance必填display_nameinstitution_name

update_manual_crypto

Update a manually-managed crypto balance. Only the supplied fields change. The symbol of an existing balance cannot be changed.

輸入參數namebalancecrypto_id必填display_nameinstitution_name

delete_manual_crypto

Delete a manually-managed crypto asset. If the asset has balance history, keep_history must be set explicitly or the API rejects the request. Irreversible.

輸入參數crypto_id必填keep_history

get_all_synced_crypto

Get all synced crypto accounts (Coinbase, Kraken, Ethereum wallets) and their nested per-symbol balances. Synced accounts are connected in the Lunch Money web app and cannot be created or edited through the API.

無需輸入參數。

get_single_synced_crypto

Get a single synced crypto account and all its nested balances by ID.

輸入參數crypto_id必填

get_synced_crypto_balance

Get a single balance held inside a synced crypto account, looked up by its cryptocurrency symbol.

輸入參數symbol必填crypto_id必填

refresh_synced_crypto

Trigger a balance refresh for a synced crypto account and return the refreshed account. Reaches out to the external crypto provider.

輸入參數crypto_id必填

get_balance_history

Get monthly account balance history across all accounts — the data behind the Net Worth views in the LunchMoney app. History is monthly. With no month range, returns all available history plus an ephemeral `current` entry for the current month, which is calculated on demand and may change between requests. Only months with data are included.

輸入參數end_monthstart_month

get_account_balance_history

Get monthly balance history for a single account. Call get_all_manual_accounts, get_all_plaid_accounts, or get_all_manual_crypto first to discover ids. For deleted accounts, use the deleted_account_id from get_balance_history. For synced crypto holdings use get_crypto_synced_balance_history instead.

輸入參數end_monthaccount_id必填start_monthaccount_type必填

upsert_account_balance_history

Create or update monthly balance history entries for a single account. Every month must be a past calendar month — the current month is calculated on demand and cannot be written. The request is all-or-nothing: if any entry fails validation, none are applied. The response contains only the entries submitted, not the account's full history.

輸入參數balances必填account_id必填account_type必填

delete_account_balance_history

Delete ALL historical balance entries for a single account. This is irreversible and affects the Net Worth views. To remove a single month, use delete_balance_history_entry instead.

輸入參數account_id必填account_type必填

get_crypto_synced_balance_history

Get monthly balance history for a synced crypto holding, identified by its account id and ticker symbol. Synced crypto is scoped per symbol, so it is not available through get_account_balance_history.

輸入參數symbol必填end_monthaccount_id必填start_month

upsert_crypto_synced_balance_history

Create or update monthly balance history entries for a synced crypto holding. Every month must be a past calendar month. If an entry sets `symbol`, it must match the symbol argument. The request is all-or-nothing.

輸入參數symbol必填balances必填account_id必填

delete_crypto_synced_balance_history

Delete ALL historical balance entries for a synced crypto holding. This is irreversible and affects the Net Worth views.

輸入參數symbol必填account_id必填

delete_balance_history_entry

Delete a single historical balance entry by its id. The id must come from an entry with type=historical in a balance history response; ephemeral `current` entries have no id and cannot be deleted.

輸入參數entry_id必填

update_deleted_account_details

Update the display details shown for a deleted account in the Net Worth views. Applies to all historical entries for that deleted source. At least one field must be provided; pass null to clear a field.

輸入參數masknamesubtypeaccount_id必填account_typedisplay_nameinstitution_name

版本歷史

2
  1. v4.0.1最新Nov 8, 2026
  2. v3.0.0Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分