Skip to main content

lunchmoney-app

MCP-first access to your Lunch Money data

GitHub GitHub License CI Status docs

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?”

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lunchmoney_app-0.12.0.tar.gz (692.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lunchmoney_app-0.12.0-py3-none-any.whl (272.0 kB view details)

Uploaded Python 3

File details

Details for the file lunchmoney_app-0.12.0.tar.gz.

File metadata

  • Download URL: lunchmoney_app-0.12.0.tar.gz
  • Upload date:
  • Size: 692.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for lunchmoney_app-0.12.0.tar.gz
Algorithm Hash digest
SHA256 10d9ca45bf806dba5c892768cf22ed035c3b1112c15516a3886dd790125413d3
MD5 572c61764e1253b29e443f91774d4843
BLAKE2b-256 f98385f24acbdba0aa66914f6b9262a1372c09a87545ffb28cf6cf39060a38e1

See more details on using hashes here.

Provenance

The following attestation bundles were made for lunchmoney_app-0.12.0.tar.gz:

Publisher: publish.yaml on juftin/lunchmoney-app

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lunchmoney_app-0.12.0-py3-none-any.whl.

File metadata

  • Download URL: lunchmoney_app-0.12.0-py3-none-any.whl
  • Upload date:
  • Size: 272.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for lunchmoney_app-0.12.0-py3-none-any.whl
Algorithm Hash digest
SHA256 abcd4f35594e1fa6a763db1a9e4e85d644facf56adce00dc35c42bad55f3b9ff
MD5 2a2e2b4fb89c71eed6305acb9db5aefa
BLAKE2b-256 b886154485345885c84bd9bc5f7c8323244757e9e0e78dbd01f42b491e85682b

See more details on using hashes here.

Provenance

The following attestation bundles were made for lunchmoney_app-0.12.0-py3-none-any.whl:

Publisher: publish.yaml on juftin/lunchmoney-app

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.14.0

2 files

0.13.0

2 files

This release

0.12.0 This release

2 files

0.11.1

2 files

0.11.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page