Lunch Money MCP Server

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

Remote serverstreamable-httpTypeScript

What is the Lunch Money MCP Server?

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

The short version

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.

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.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

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_userRetrieve current user details
get_all_categoriesList all categories (supports format and is_group filters)
get_single_categoryGet details for a specific category or category group
create_categoryCreate a category or category group (set is_group=true plus children)
update_categoryUpdate properties; replaces the children list on category groups
delete_categoryDelete a category; pass force=true to override dependency check
get_all_tagsList all tags
get_single_tagGet a tag by ID
create_tagCreate a new tag
update_tagUpdate tag properties
delete_tagDelete a tag (with force to override dependents)
get_transactionsList transactions with extensive filtering options (date range, account, category, tag, status, pending, metadata, files, etc)
get_single_transactionGet full transaction details (always includes plaid_metadata, custom_metadata, files, and children for split/group parents)
create_transactionsInsert 1–500 transactions in one call

How to install the Lunch Money MCP Server

{
  "mcpServers": {
    "lunchmoney": {
      "command": "npx",
      "args": ["-y", "@akutishevsky/lunchmoney-mcp"],
      "env": {
        "LUNCHMONEY_API_TOKEN": "your-value",
        "LUNCHMONEY_DEBUG": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
LUNCHMONEY_API_TOKENCredential the server authenticates with.Yes
LUNCHMONEY_DEBUGConfiguration value read at startup.Optional

Example prompts to try

  • “Use Lunch Money to get user.”
  • “Use Lunch Money to get all categories.”
  • “Use Lunch Money to get single category.”

Frequently asked questions

MCP server for managing LunchMoney personal finances: transactions, budgets, categories, and more. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.