About Lunch Money MCP
Lunch Money MCP gives MCP-enabled assistants access to Lunch Money data. It can also run as a standalone app with a REST API and database that syncs the data.
Key features
- 01Access Lunch Money data
- 02RESTful API
- 03Database syncs account data
Use cases
- 01Check monthly dining spend
- 02Review recent large transactions
- 03Find uncategorized transactions
MCP support
It is an MCP server that provides Lunch Money data to MCP-enabled assistants; the client starts and manages it.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMElunchmoney-app
MCP-first access to your Lunch Money data
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.
- Create or copy your Lunch Money access token.
- Add the configuration below to your MCP client's server settings.
- 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?”
Install in Claude Code, Codex, Gemini CLI, or Claude Desktop
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.
| Client | Install |
|---|---|
| Claude Code | claude plugin marketplace add juftin/lunchmoney-app && claude plugin install lunchmoney-mcp@lunchmoney-app |
| Codex | codex plugin marketplace add juftin/lunchmoney-app && codex plugin add lunchmoney-mcp@lunchmoney-app |
| Gemini CLI | gemini extensions install https://github.com/juftin/lunchmoney-app |
| Claude Desktop | Download lunchmoney-app.mcpb from a release and open it. |
For direct standard-MCP setup and framework-specific token configuration, see the MCP guide.
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.