Lunch Money for Agents

https://github.com/n3wth/lunchmoney-mcp
Admin
Unofficial MCP integration for read-only access to Lunch Money transactions, accounts, budgets,...
Tokens:5,578
Snippets:59
Trust Score:6.9
License:MIT
Update:1 month ago
Show doc for...
Tokens:
Raw
================
LIBRARY RULES
================
- Financial data access is read-only. Connection tools can link, replace, or disconnect the service but cannot edit Lunch Money records or move money.
- Use https://mcp.lunchmoney.sh/mcp for production. Staging requires a separate connection.
- Enter Lunch Money API tokens only in the Nango browser connection flow returned by lunchmoney_connect, never in chat, tool arguments, or client configuration.
- Transaction results are paginated. Follow next_offset until it is null before claiming a complete total for a date range.
- Preserve decimal values and currencies as returned. Keep totals separate by currency unless the user explicitly requests a conversion.
- Disconnecting removes the service connection, not the underlying Lunch Money token. Revoke that token in Lunch Money; uninstalling a plugin does not disconnect the service.

================
CODE SNIPPETS
================
### Clone and preview the site

Source: https://github.com/n3wth/lunchmoney-mcp/blob/main/README.md

Clones the repository, installs dependencies, and starts the preview server at http://localhost:4173. Requires Node.js 22 or later.

```bash
git clone https://github.com/n3wth/lunchmoney-mcp.git
cd lunchmoney-mcp
npm ci
npm run preview
```

--------------------------------

### Install Lunch Money plugin via marketplace

Source: https://github.com/n3wth/lunchmoney-mcp/blob/main/packages/claude-plugin/README.md

Run these Claude Code commands sequentially. The first adds the custom marketplace, and the second installs the lunchmoney plugin from that marketplace. Requires a new session after installation.

```text
/plugin marketplace add n3wth/lunchmoney-mcp
/plugin install lunchmoney@lunchmoney-mcp
```

--------------------------------

### Load plugin for local development

Source: https://github.com/n3wth/lunchmoney-mcp/blob/main/packages/claude-plugin/README.md

Starts a Claude Code session using this package from the repository root. Does not publish a marketplace entry or install persistently; use the install commands above for a permanent setup.

```sh
claude --plugin-dir ./packages/claude-plugin
```

--------------------------------

### Install Lunch Money plugin via Codex CLI

Source: https://github.com/n3wth/lunchmoney-mcp/blob/main/packages/codex-plugin/README.md

Adds the custom marketplace and installs the Lunch Money plugin from it. Run these commands in a terminal to install the plugin without using the Codex app UI.

```sh
codex plugin marketplace add n3wth/lunchmoney-mcp
codex plugin add codex-plugin@lunchmoney-mcp
```

--------------------------------

### Run server checks in dependency order

Source: https://github.com/n3wth/lunchmoney-mcp/blob/main/README.md

Runs server checks in dependency order: installs and tests auth-contract, lunchmoney-adapter, and server packages, then runs the release validation script.

```bash
npm --prefix packages/auth-contract ci
npm --prefix packages/auth-contract test
npm --prefix packages/lunchmoney-adapter ci
npm --prefix packages/lunchmoney-adapter test
npm --prefix packages/server ci
npm --prefix packages/server test
node scripts/validate-release.mjs
```

--------------------------------

### Manual config.toml for Lunch Money MCP server

Source: https://github.com/n3wth/lunchmoney-mcp/blob/main/packages/codex-plugin/README.md

Manual configuration for the Lunch Money MCP server in config.toml. Uses snake_case keys, unlike the camelCase OAuth fields in the plugin's .mcp.json. The callback URI must exactly match the registered Auth0 URI, and port 1455 must be available during login. Avoid using both manual and plugin configuration simultaneously to prevent duplicate tool connections.

```toml
mcp_oauth_callback_port = 1455

[mcp_servers.lunchmoney]
url = "https://mcp.lunchmoney.sh/mcp"

[mcp_servers.lunchmoney.oauth]
client_id = "xDAFMwYkwjC3GiWoKsrQvZaEqOg8sbxI"
callback_url = "http://127.0.0.1:1455/callback"
callback_port = 1455
```

--------------------------------

### Validate plugin manifest

Source: https://github.com/n3wth/lunchmoney-mcp/blob/main/packages/claude-plugin/README.md

Validates the Claude plugin manifest from the repository root. Note that validation does not verify browser login, external-user access, or Claude Desktop/Cowork compatibility.

```sh
claude plugin validate ./packages/claude-plugin
```

--------------------------------

### Hosted MCP endpoint URL

Source: https://github.com/n3wth/lunchmoney-mcp/blob/main/README.md

The hosted MCP endpoint URL for connecting Lunch Money to MCP clients. Use this as the server URL when configuring a client that supports remote servers with OAuth sign-in.

```text
https://mcp.lunchmoney.sh/mcp
```
Tokens:
Raw