Lunchmoney Mcp V2 MCP Server

MCP server for the Lunch Money API v2. First MCP server built on the v2 API.

Local serverstdio

What is the Lunchmoney Mcp V2 MCP Server?

Lunchmoney Mcp V2 is an MCP project maintained in the leafeye/lunchmoney-mcp-v2 repository. The maintainer describes its purpose as “MCP server for the Lunch Money API v2. First MCP server built on the v2 API”. Read the project documentation for the complete scope.

Installation

The documented npm package is lunchmoney-mcp-v2. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares LUNCHMONEY_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_userAccount info (name, email, currency)
list_transactionsList/search transactions with filters, or look up by ID
list_categoriesAll categories (nested or flat view)
list_tagsAll tags
get_accountsManual + synced accounts with balances
get_summaryBudget summary with income/spending/per-category breakdown
get_recurringRecurring items (subscriptions, bills, income)
manage_transactioncreate, update, delete
manage_categorycreate, update, delete
manage_tagcreate, update, delete
manage_accountcreate, update, delete
bulk_update_transactions—
split_transactionsplit, unsplit
group_transactionsgroup, ungroup

How to install the Lunchmoney Mcp V2 MCP Server

{
  "mcpServers": {
    "lunchmoney": {
      "command": "npx",
      "args": [
        "lunchmoney-mcp-v2"
      ],
      "env": {
        "LUNCHMONEY_TOKEN": "YOUR_LUNCHMONEY_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
LUNCHMONEY_TOKENDeclared in the maintainer’s client configuration.Check documentation