Cover image
Try Now
2025-02-28

3 years

Works with Finder

1

Github Watches

2

Github Forks

6

Github Stars

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.

What is this?

This tool allows you to connect your Lunchmoney financial data to Claude AI, so you can ask questions about your spending, analyze your budget, and get insights about your finances through a natural conversation.

Features

This server provides four main tools:

  1. get-recent-transactions: View your recent transactions from the past N days
  2. search-transactions: Search transactions by keyword in payee names or notes
  3. get-category-spending: Analyze spending in specific categories
  4. get-budget-summary: Get detailed budget information including spending, remaining amounts, and recurring items

Privacy and Data Handling

Important: MCP provides a structured way for Claude to interact with your Lunchmoney data while maintaining privacy boundaries. Here's what you should know:

  • Claude (the host) creates a client that connects to your local MCP server
  • Your Lunchmoney API token stays on your local machine
  • The MCP server runs locally and fetches data from Lunchmoney's API
  • You will be asked to approve each request to access your Lunchmoney data
  • When you ask a question about your finances, Claude requests specific information from the MCP server
  • The MCP server processes your request locally and returns only the relevant results
  • Claude never has direct access to your full financial data or API token
  • Only the specific information requested (like transaction summaries or budget status) is shared with Claude
  • Anthropic's data retention policies apply to these summary results that are part of your conversation
  • Each server connection is isolated, maintaining clear security boundaries

You can find more about MCP in the documentaion: https://modelcontextprotocol.io/introduction

Installation

Also look at the offical Claude documentation: https://modelcontextprotocol.io/quickstart/user

Using npx

Node.js is a software platform that lets you run JavaScript code on your computer (outside of a web browser).

To install Node.js:

  • Windows/Mac: Download and run the installer from the official Node.js website
  • Mac with Homebrew: Run brew install node in Terminal
  • Linux: Use your package manager (e.g., sudo apt install nodejs for Ubuntu)

Once Node.js is installed on your computer, you can run the server directly without downloading anything:

  1. Get your Lunchmoney API token from your Lunchmoney developer settings
  2. Open Claude Desktop
  3. Go to Settings → Developer -> Edit Config
  4. Add the following configuration:
{
  "mcpServers": {
    "lunchmoney": {
      "command": "npx",
      "args": ["-y", "lunchmoney-mcp-server"],
      "env": {
        "LUNCHMONEY_TOKEN": "your_token_here"
      }
    }
  }
}

Replace your_token_here with your actual Lunchmoney API token.

Important Note: After changing the configuration, you may need to restart Claude Desktop for the changes to take effect.

Example Usage

Once configured in Claude Desktop, you can ask questions like:

Transactions

  • "Show me my recent transactions from the past week"
  • "Search for all transactions at Amazon"
  • "How much did I spend on restaurants last month?"
  • "Find transactions tagged as business expenses"

Budgets

  • "Show me my budget summary for this month"
  • "What's my budget status from January to March 2024?"
  • "How much of my food budget is remaining?"
  • "Show me categories where I'm over budget"

What is MCP?

The Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). Think of MCP like a USB-C port for AI applications - it provides a standardized way to connect AI models to different data sources and tools.

Some key benefits of MCP:

  • Standardized way to expose data and functionality to LLMs
  • Human-in-the-loop security (all actions require user approval)
  • Growing ecosystem of pre-built integrations
  • Works with multiple AI models and applications

Troubleshooting

Claude says it can't connect to my MCP server:

  • Make sure the configuration in Claude's Developer settings is correct
  • Try restarting Claude Desktop after changing the configuration
  • Check that your Lunchmoney API token is valid

Claude doesn't recognize Lunchmoney commands:

  • Start a new conversation in Claude
  • Try explicitly mentioning Lunchmoney in your query (e.g., "Show me my recent Lunchmoney transactions")

API Notes

  • Budget data must use month boundaries for dates (e.g., 2024-01-01 to 2024-01-31)
  • Transactions can use any date range
  • All monetary values are returned in their original currency

License

MIT

Contributing

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

相关推荐

  • NiKole Maxwell
  • I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Khalid kalib
  • Write professional emails

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • https://tovuti.be
  • Oede knorrepot die vasthoudt an de goeie ouwe tied van 't boerenleven

  • Gil kaminski
  • Make sure you are post-ready before you post on social media

  • Yasir Eryilmaz
  • AI scriptwriting assistant for short, engaging video content.

  • J. DE HARO OLLE
  • Especialista en juegos de palabras en varios idiomas.

  • ShrimpingIt
  • Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx

  • huahuayu
  • A unified API gateway for integrating multiple etherscan-like blockchain explorer APIs with Model Context Protocol (MCP) support for AI assistants.

  • deemkeen
  • control your mbot2 with a power combo: mqtt+mcp+llm

  • zhaoyunxing92
  • 本项目是一个钉钉MCP(Message Connector Protocol)服务,提供了与钉钉企业应用交互的API接口。项目基于Go语言开发,支持员工信息查询和消息发送等功能。

  • apappascs
  • Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.

  • OffchainLabs
  • Go implementation of Ethereum proof of stake

    Reviews

    1 (1)
    Avatar
    user_LNaLTXvI
    2025-04-16

    I have been using the lunchmoney-mcp-server created by leafeye, and it has been a game changer for managing my personal finances. The server is intuitive and robust, allowing seamless integration with various financial tools. Its user-friendly interface and reliable performance make budget tracking efficient and stress-free. I highly recommend this server to anyone looking to streamline their financial management process. Well done, leafeye!