moneylover-mcp
This MCP server lets an MCP-compatible client access and manage a MoneyLover account through MoneyLover’s unofficial web API.
Authenticate with MoneyLover credentials and cache a JWT token.
Retrieve the authenticated user’s profile.
List wallets available to the user.
List categories for a specific wallet.
Fetch wallet transactions over a date range in
YYYY-MM-DDformat.Create transactions in a wallet, including optional note and related parties, with automatic translation of wallet-specific category IDs to global IDs.
Use an explicit token argument to override environment-based authentication.
Automatically refresh cached tokens on expiry when environment credentials are supplied.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@moneylover-mcp show my wallets and this month's transactions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
moneylover-mcp
An unofficial Model Context Protocol (MCP) server for MoneyLover, exposed over stdio for MCP-compatible clients.
MoneyLover provides no official public API. This server uses the unofficial web API employed by the MoneyLover web application. It may cease to function if that API changes.
Contents
Related MCP server: wallet-mcp
Requirements
Node.js. The project does not pin a minimum version in
package.json(noenginesfield).A MoneyLover account. No official public API is used; see Security.
Features
Wallet, category, and transaction retrieval.
Transaction creation, with category identifiers resolved to the global form required by the transaction endpoint.
Token caching with automatic refresh on expiry, when environment credentials are supplied.
Quick start
npm install
npm start{
"mcpServers": {
"moneylover": {
"command": "node",
"args": ["/path/to/moneylover-mcp/src/server.js"],
"env": {
"EMAIL": "you@example.com",
"PASSWORD": "your-password"
}
}
}
}A token argument to any tool overrides environment authentication.
Verify it works by calling get_wallets from your MCP client — it should
list your MoneyLover wallets. If calls fail with error 706, see
Refreshing an expired token.
Tools
Tool | Description |
| Authenticate and cache an access token. |
| Retrieve the authenticated user profile. |
| List wallets. |
| List categories for a wallet. |
| List transactions for a wallet over a date range. |
| Create a transaction in a wallet. |
Refreshing an expired token
The server only auto-refreshes on error 717 / token_device_not_found.
If calls start failing with error 706 (Not authorized), fetch a fresh
token with the standalone script (Python 3, standard library only; the
password is prompted with getpass and never stored):
python3 scripts/refresh_token.py --email you@example.comIt runs the same two-step login as the server, verifies the token with
wallet/list, and caches it at ~/.moneylover-mcp/<base64url(email)>.json
(directory 0700, file 0600). Its tests are mocked and need no network:
python3 test/refresh_token.test.pySecurity
Only MoneyLover hosts are contacted:
https://web.moneylover.me/apiandhttps://oauth.moneylover.me/token.Runtime dependencies are limited to
@modelcontextprotocol/sdkandzod.Access tokens are cached as plaintext JSON in
~/.moneylover-mcp/<base64url(email)>.json(directory0700, file0600). Delete that directory to revoke stored sessions.No
.envfile is loaded. Credentials are taken only from the host environment or explicit tool arguments.
Development
npm testContributing
Issues and pull requests are welcome. Please describe the problem or change clearly, keep changes focused, and include test evidence where applicable.
Releases
See Releases for published versions. Current release: v0.1.0 (initial release).
License
MIT. This project is not affiliated with, endorsed by, or connected to MoneyLover.
Available Tools
6 toolsadd_transactionAdd TransactionB
Create a new transaction in a wallet. categoryId may be a wallet-specific id from get_categories or a global category id; it is translated to the global id the current API expects.
Inputs: date (required), amount (required), walletId (required), categoryId (required), +3 more.
get_categoriesGet CategoriesB
List categories for a wallet. Note: the ids returned here are wallet-specific; add_transaction translates them to global ids automatically.
Inputs: walletId (required), token.
get_transactionsGet TransactionsC
Fetch transactions for a wallet between two dates (YYYY-MM-DD).
Inputs: endDate (required), walletId (required), startDate (required), token.
get_user_infoGet User InfoB
Retrieve the Money Lover user profile associated with the token.
Inputs: token.
get_walletsGet WalletsB
List wallets available to the authenticated user.
Inputs: token.
loginLoginB
Authenticate using Money Lover credentials to retrieve a JWT token (cached locally).
Inputs: email (required), password (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct resource and action: authentication, user profile, wallets, categories, transaction listing, and transaction creation. There is no meaningful overlap in purpose, and the descriptions make the boundaries clear.
All names use snake_case and mostly follow a verb_noun pattern (get_user_info, get_wallets, add_transaction). The exception is 'login', which is a single verb rather than verb_noun, but it remains clear and readable.
Six tools is well-scoped for a focused Money Lover client covering authentication, profile, wallets, categories, and transactions. Each tool has a clear role, and there is no unnecessary bloat.
The surface covers login, lookup, and adding a transaction, but notable lifecycle operations are missing: there is no update or delete for transactions, and no create/update/delete for wallets or categories. These gaps could cause agent failures when users need to correct or manage existing data.
Maintenance
Related MCP Connectors
Authenticated MCP access to WebMoney wallets, transactions, messages and invoices.
Query your real net worth, spending, transactions, budgets and portfolio from any MCP client.
Multi-currency budgeting: read and update your accounts, transactions, categories and budgets.
Log, query, and edit expenses, budgets, and accounts in Manilo from any MCP-compatible AI assistant.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Money Lover personal finance app through unofficial REST API. Supports authentication, wallet management, transaction querying, and creating new transactions for expense tracking.623 npm7ISC
- AlicenseNot gradedqualityDmaintenanceMCP server for the BudgetBakers Wallet REST API, enabling management of transactions, accounts, categories, budgets, labels, and more through natural language.MIT
- AlicenseAqualityBmaintenanceProvides tools to read Money Lover account data and add transactions, with features for previewing, duplicate detection, reconciliation, and safe batch import of bank/card statement JSON via an MCP client.8MIT
- AlicenseNot gradedqualityBmaintenanceEnables full CRUD and lending management for Money Lover transactions, wallets, categories, and lending records via MCP, with both local and HTTP transports.96 npmMIT