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

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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

ACI: Open-Source Infra to Power Unified MCP Servers

aipotheosis-labs

ACI.dev is the open source tool-calling platform that hooks up 600+ tools into any agentic IDE or custom AI agent through direct function calling or a unified MCP server. The birthplace of VibeOps.

4.8K