Lunchmoney MCP Server

@MCP-Mirror

About Lunchmoney MCP Server

Mirror of

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "leafeye_lunchmoney-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@leafeye/lunchmoney-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Lunchmoney MCP Server?

A Model Context Protocol (MCP) server that lets you interact with your Lunchmoney transactions and budgets through Claude and other AI assistants.

How to use Lunchmoney MCP Server?

Configure it in Claude Desktop via the mcpServers section with your Lunchmoney API token, or install automatically via Smithery. You can then ask questions about recent transactions, search transactions, analyze category spending, and get budget summaries.

Key features of Lunchmoney MCP Server

View recent transactions from the past N days
Search transactions by keyword in payee names or notes
Analyze spending in specific categories
Get detailed budget summaries with spending and remaining amounts
Recurring budget items are included in reports

Use cases of Lunchmoney MCP Server

Quickly ask for recent transactions without opening the Lunchmoney app
Search for all transactions at a specific merchant (e.g., Amazon)
Check how much you spent in a category (e.g., restaurants) last month
Get a budget summary for the current month or a custom date range
Identify categories where you are over budget

FAQ from Lunchmoney MCP Server

What do I need to use Lunchmoney MCP Server?

You need a Lunchmoney API token, which you can get from your Lunchmoney developer settings. The token is set as the LUNCHMONEY_TOKEN environment variable.

How do I install Lunchmoney MCP Server?

You can install it automatically via Smithery (npx -y @smithery/cli install ...) or manually by adding the server configuration to your Claude Desktop config file with npx -y lunchmoney-mcp-server.

What date formats are supported?

Budget data must use month boundaries (e.g., 2024-01-01 to 2024-01-31). Transactions can use any date range.

Are category names case-sensitive?

No, category names are case-insensitive when searching.

What currency are monetary values returned in?

All monetary values are returned in their original currency (as stored in Lunchmoney).

Frequently asked questions

What do I need to use Lunchmoney MCP Server?

You need a Lunchmoney API token, which you can get from your Lunchmoney developer settings. The token is set as the `LUNCHMONEY_TOKEN` environment variable.

How do I install Lunchmoney MCP Server?

You can install it automatically via Smithery (`npx -y @smithery/cli install ...`) or manually by adding the server configuration to your Claude Desktop config file with `npx -y lunchmoney-mcp-server`.

What date formats are supported?

Budget data must use month boundaries (e.g., 2024-01-01 to 2024-01-31). Transactions can use any date range.

Are category names case-sensitive?

No, category names are case-insensitive when searching.

What currency are monetary values returned in?

All monetary values are returned in their original currency (as stored in Lunchmoney).

Comments

Basic information

More Other MCP servers

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep