lunchmoney-app

lunchmoney-app is first and foremost an MCP server for using your Lunch Money data from an MCP-enabled assistant. It also runs as a standalone application with a RESTful API and database backend that keeps itself in sync with all of your Lunch Money data.

Quickstart

Use Lunch Money from your favorite MCP-enabled assistant in a few minutes.

1. Create or copy your Lunch Money access token.

2. Add the configuration below to your MCP client's server settings.

3. Replace your-lunch-money-token, restart the client, and start chatting.

Your MCP client starts and manages Lunch Money MCP for you; do not run a separate server command.

{
    "mcpServers": {
        "lunchmoney": {
            "command": "uvx",
            "args": ["lunchmoney-app", "mcp"],
            "env": {
                "LUNCHMONEY_ACCESS_TOKEN": "your-lunch-money-token"
            }
        }
    }
}

Try asking:

• “How much did I spend on dining this month?”

• “Show my largest recent transactions.”

• “Which transactions still need a category?”

Claude Code, Codex, and Gemini CLI use the published package through uvx; install uv first. Claude Desktop manages the MCPB runtime itself. Provide your Lunch Money access token through LUNCHMONEY_ACCESS_TOKEN unless the client prompts for it.

For direct standard-MCP setup and framework-specific token configuration, see the MCP guide.

Related MCP server: lunchmoney-mcp-v2

Learn more

• MCP guide: client configuration, remote connections, and OAuth.

• CLI guide: commands, data handling, scheduling, and shell completion.

• Operations runbook: self-hosting, Docker Compose, security, and backups.