{
  "markdown": "<h1 align=\"center\">lunchmoney-app</h1>\n\n<p align=\"center\">\n    MCP-first access to your Lunch Money data\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/juftin/lunchmoney-app\"><img src=\"https://img.shields.io/github/v/release/juftin/lunchmoney-app?color=blue&label=lunchmoney-app&logo=github\" alt=\"GitHub\"></a>\n  <a href=\"https://github.com/juftin/lunchmoney-app/blob/main/LICENSE\"><img src=\"https://img.shields.io/github/license/juftin/lunchmoney-app?color=blue&label=License\" alt=\"GitHub License\"></a>\n  <a href=\"https://github.com/juftin/lunchmoney-app/actions/workflows/ci.yaml?query=branch%3Amain\"><img src=\"https://github.com/juftin/lunchmoney-app/actions/workflows/ci.yaml/badge.svg?branch=main\" alt=\"CI Status\"></a>\n  <a href=\"https://juftin.github.io/lunchmoney-app/\"><img src=\"https://img.shields.io/static/v1?message=docs&color=526CFE&logo=Material+for+MkDocs&logoColor=FFFFFF&label=\" alt=\"docs\"></a>\n</p>\n\n`lunchmoney-app` is first and foremost an [MCP](https://modelcontextprotocol.io/)\nserver for using your Lunch Money data from an MCP-enabled assistant. It also runs\nas a standalone application with a RESTful API and database backend that keeps\nitself in sync with all of your Lunch Money data.\n\n## Quickstart\n\nUse Lunch Money from your favorite MCP-enabled assistant in a few minutes.\n\n1. Create or copy your Lunch Money access token.\n2. Add the configuration below to your MCP client's server settings.\n3. Replace `your-lunch-money-token`, restart the client, and start chatting.\n\nYour MCP client starts and manages Lunch Money MCP for you; do not run a\nseparate server command.\n\n```json\n{\n    \"mcpServers\": {\n        \"lunchmoney\": {\n            \"command\": \"uvx\",\n            \"args\": [\"lunchmoney-app\", \"mcp\"],\n            \"env\": {\n                \"LUNCHMONEY_ACCESS_TOKEN\": \"your-lunch-money-token\"\n            }\n        }\n    }\n}\n```\n\nTry asking:\n\n- “How much did I spend on dining this month?”\n- “Show my largest recent transactions.”\n- “Which transactions still need a category?”\n\n<details>\n<summary>Install in Claude Code, Codex, Gemini CLI, or Claude Desktop</summary>\n\nClaude Code, Codex, and Gemini CLI use the published package through `uvx`; install\n[uv](https://docs.astral.sh/uv/getting-started/installation/) first. Claude Desktop\nmanages the MCPB runtime itself. Provide your Lunch Money access token through\n`LUNCHMONEY_ACCESS_TOKEN` unless the client prompts for it.\n\n| Client         | Install                                                                                                      |\n| :------------- | :----------------------------------------------------------------------------------------------------------- |\n| Claude Code    | `claude plugin marketplace add juftin/lunchmoney-app && claude plugin install lunchmoney-mcp@lunchmoney-app` |\n| Codex          | `codex plugin marketplace add juftin/lunchmoney-app && codex plugin add lunchmoney-mcp@lunchmoney-app`       |\n| Gemini CLI     | `gemini extensions install https://github.com/juftin/lunchmoney-app`                                         |\n| Claude Desktop | Download `lunchmoney-app.mcpb` from a release and open it.                                                   |\n\nFor direct standard-MCP setup and framework-specific token configuration, see\nthe [MCP guide](docs/MCP_GUIDE.md).\n\n</details>\n\n<!-- mcp-name: io.github.juftin/lunchmoney-app -->\n\n## Learn more\n\n- [MCP guide](docs/MCP_GUIDE.md): client configuration, remote connections, and OAuth.\n- [CLI guide](docs/CLI.md): commands, data handling, scheduling, and shell completion.\n- [Operations runbook](docs/OPERATIONS.md): self-hosting, Docker Compose, security, and backups.\n",
  "bytes": 3656,
  "sha": "f05947c1bae38b53907986373b05785c7bacd153c1afd2e9bb373660a85891f2",
  "repo_slug": "juftin/lunchmoney-app",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_juftin_lunchmoney_app_a2c93f0b/readme"
}