Lunch Money

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

claude mcp add --env LUNCHMONEY_API_TOKEN=your-value --transport stdio lunch-money -- npx -y @akutishevsky/lunchmoney-mcp

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

{
  "inputs": [
    {
      "type": "promptString",
      "id": "lunchmoney_api_token",
      "description": "LUNCHMONEY_API_TOKEN",
      "password": true
    }
  ],
  "servers": {
    "lunch-money": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@akutishevsky/lunchmoney-mcp"
      ],
      "env": {
        "LUNCHMONEY_API_TOKEN": "${input:lunchmoney_api_token}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

• get_user

  Retrieve current user details

• get_all_categories

  List all categories (supports format and isgroup filters)

• get_single_category

  Get details for a specific category or category group

• create_category

  Create a category or category group (set isgroup=true plus children)

• update_category

  Update properties; replaces the children list on category groups

• delete_category

  Delete a category; pass force=true to override dependency check

• get_all_tags

  List all tags

• get_single_tag

  Get a tag by ID

• create_tag

  Create a new tag

• update_tag

  Update tag properties

• delete_tag

  Delete a tag (with force to override dependents)

• get_transactions

  List transactions with extensive filtering options (date range, account, category, tag, status, pending, metadata,…

• get_single_transaction

  Get full transaction details (always includes plaidmetadata, custommetadata, files, and children for split/group…

• create_transactions

  Insert 1–500 transactions in one call

• update_transaction

  Partial update of one transaction

• delete_transaction

  Delete one transaction (cannot be split/group)

• update_transactions_bulk

  Bulk update 1–500 transactions

• delete_transactions_bulk

  Bulk delete 1–500 transactions by ID

• create_transaction_group

  Create a transaction group from existing transactions

• delete_transaction_group

  Ungroup a transaction group

• split_transaction

  Split a transaction into 2–500 children

• unsplit_transaction

  Undo a previous split

• attach_file_to_transaction

  Upload a local file (jpeg/png/heic/heif/pdf, ≤10MB), type verified from its contents

• get_transaction_attachment_url

  Get a signed download URL for a file attachment

• delete_transaction_attachment

  Delete a file attachment

• get_recurring_items

  List recurring items for a date range (includesuggested for system suggestions)

• get_single_recurring_item

  Get a recurring item by ID

• get_budget_summary

  Per-category budget summary (backed by /summary); supports occurrences, totals, rollover-pool toggles

• get_budget_settings

  Account-wide budget period and display settings

• upsert_budget

  Create or update a budget for a category and period

• remove_budget

  Remove a budget for a category and period

• get_all_manual_accounts

  List all manually-managed accounts (formerly "assets")

• get_single_manual_account

  Get a manual account by ID

• create_manual_account

  Create a new manually-managed account

• update_manual_account

  Update properties of a manual account

• delete_manual_account

  Delete a manual account; optionally also delete its transactions / balance history

• get_all_plaid_accounts

  List all connected Plaid accounts

• get_single_plaid_account

  Get a Plaid account by ID

• trigger_plaid_fetch

  Trigger fetch of latest data from Plaid (optionally scoped to a date range or account)

• get_supported_cryptocurrencies

  List the cryptocurrencies supported for manual tracking

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.

• lunchmoney
• lunchmoney-api
• mcp
• mcp-server
• model-context-protocol
• mcpb