MoneyMatter
Server Details
Personal finance tracker: accounts, transactions, budgets, investments and analytics over OAuth.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- letehaha/moneymatter
- GitHub Stars
- 160
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 56 tools
Most tools have distinct resource+action targets, but several clusters overlap noticeably: get_refunds vs get_refund_links describe the same refund-link data, and get_expenses_for_period, get_transactions_summary, get_spending_by_categories and get_cumulative_stats all return overlapping spend totals for a date range. Tag operations are also spread across assign_tags_to_transaction, remove_tags_from_transaction, bulk_update_transactions and update_transaction, forcing the agent to infer which is canonical.
Every tool follows a snake_case verb_noun pattern (get_*, create_*, update_*, delete_*, bulk_*, link_*/unlink_*), so the action and target are predictable from the name alone. Plural/singular variants (get_account vs get_accounts) are used deliberately to signal single-entity vs list reads.
56 tools is heavy even for a full personal-finance domain, and the surface is split very finely (separate bulk_* variants, four tag-mutation paths, multiple redundant report tools). The breadth across accounts, transactions, categories, payees, tags, refunds, transfers, attachments and analytics is largely justified, but consolidation would materially reduce selection burden.
Coverage is strong: full CRUD lifecycles for accounts, transactions, categories, tags, payees and splits, plus archive, bulk operations, linking, attachments and a rich analytics surface. Minor dead ends remain, notably get_refunds pointing to a get_refund_recommendations tool that is not present in this set, and file upload requiring an out-of-band HTTP client.
Publisher details
- Operator
- Individual
- Operator website
- Not applicable
- Vendor relationship
- Not applicable
- Documentation
- https://docs.moneymatter.app/ · Publisher source
- Privacy policy
- Not provided
- Trust center
- Not applicable
- Restrictions
- Cloud is under subscription, self-hosted is free · Publisher source
Available Tools
56 toolsadjust_account_balanceAInspect
Set an account to a specific balance by creating an adjustment transaction for the difference. Returns the previous balance, new balance, and the generated transaction (null if the balance was already at the target). Requires finance:write scope.
Inputs: accountId (required), newBalance (required), note, time.
archive_accountAInspect
Archive or unarchive a user account. Archiving removes the account from groups and unlinks subscriptions. Set archived=false to restore an archived account to active status. Requires finance:write scope.
Inputs: archived (required), accountId (required).
assign_tags_to_transactionAInspect
Assign one or more tags to a transaction. Use when the user wants to label a transaction with existing tags. Already-assigned tags are silently skipped. Returns counts of added and skipped tags. Requires finance:write scope.
Inputs: tagId (required), transactionIds (required).
bulk_delete_payeesADestructiveInspect
Permanently delete many payees at once. Their transactions stay and lose the payee; their aliases go with them; automations that use a deleted payee are paused. All or nothing: one unknown id refuses the whole call and deletes nothing. Returns { deletedCount, ignoredAddedCount }. Irreversible. Requires finance:delete scope.
Inputs: ids (required), ignoreFuture.
bulk_delete_transactionsADestructiveInspect
Move many transactions to Trash at once, by ids or by filters. Balances change; the user can restore them in the app within 30 days, after which they are deleted for good. Before using filters, call get_transactions_summary with the same filters and check the count. Unlike the REST endpoint, empty filters are refused: give at least one filter (a date range, account, category, …) or explicit transactionIds. Deleting one leg of a transfer moves both. Transactions on bank-connected accounts are refused (planned ones excepted), and so is a delete over the service maximum. Ids you cannot access are skipped; transactions that belong to a payment, a portfolio or a venture are skipped too and listed in skippedIds. Returns deletedCount, deletedIds and skippedIds. Requires finance:delete scope.
Inputs: filters, excludedIds, transactionIds.
bulk_update_transactionsAInspect
Update multiple transactions at once. Provide transactionIds plus at least one of categoryId, tagIds, note, payeeId (null clears the payee), or excludeFromStats. Tags can be added to, removed from, or replaced on all specified transactions. Requires finance:write scope.
Inputs: transactionIds (required), note, tagIds, payeeId, +3 more.
create_accountAInspect
Create a manual account. currencyCode is an ISO currency code. accountCategory defaults to "general"; defaultPaymentType (optional) is the payment type new transactions on the account start with; "loan" and "vehicle" are refused here (they have their own flows). initialBalance and creditLimit are decimals in the account currency. Give a logo as either logoDomain or logoInitials (+ logoColor), not both. Requires finance:write scope.
Inputs: name (required), currencyCode (required), logoIcon, logoColor, +6 more.
create_attachment_upload_urlAInspect
Get a short-lived upload URL for attaching receipt/invoice files (JPEG, PNG, WebP, PDF) to a transaction. File bytes cannot be sent through MCP: POST each file as the raw request body to the returned url with the returned headers, plus the header named by filenameHeader set to the URI-encoded original filename of that file (e.g. via curl --data-binary). The URL works for multiple files until it expires. Requires a client that can make HTTP requests with local files. Requires finance:write scope.
Inputs: transactionId (required).
create_categoryAInspect
Create a new transaction category. Supports nested categories via parentId — child categories inherit the parent color if none is provided. Use when the user wants a new category to classify transactions. Requires finance:write scope.
Inputs: name (required), icon, type, color, +3 more.
create_payeeAInspect
Create a Payee (merchant/counterparty) for the user. Use when the user wants to register a new merchant before linking transactions. Can also set the categorization mode, the default tags and the default location. Returns the created Payee. Requires finance:write scope.
Inputs: name (required), defaultTagIds, defaultLocation, defaultCategoryId, +1 more.
create_tagAInspect
Create a new tag that can be assigned to transactions. Use when the user wants to label or categorize transactions with a custom tag. Returns the created tag with its ID. Requires finance:write scope.
Inputs: name (required), color (required), icon, description.
create_transactionAInspect
Create a new transaction (income, expense, or transfer). Requires accountId, amount (decimal), transactionType, and transferNature. paymentType is optional and defaults to the default payment type of the account. For transfers, also provide destinationAccountId and destinationAmount. Use splits to categorize portions of the amount. Use originalAmount + originalCurrencyCode to record what the purchase cost in its invoice currency when that differs from the account currency. Use paymentLegs to pay one purchase from several accounts. Use payeeId to link an existing payee, or merchantName to let the server resolve a payee from a raw merchant name (it matches an existing payee by name or alias and follows the instance's normal promotion rules, so it may not create a payee on first sight); the two cannot be combined. Requires finance:write scope.
Inputs: amount (required), accountId (required), transferNature (required), transactionType (required), +21 more.
delete_accountADestructiveInspect
Permanently delete an account together with all its transactions. Irreversible: call get_account first and read its transactionCount. To keep the history, use archive_account instead. Requires finance:delete scope.
Inputs: accountId (required), removePortfolioTransfers.
delete_attachmentADestructiveInspect
Permanently delete a file attached to a transaction. Irreversible. Find attachment ids with list_transaction_attachments. Needs a plan that includes attachments. Requires finance:delete scope.
Inputs: attachmentId (required).
delete_categoryADestructiveInspect
Permanently delete a category by ID. This is destructive — if the category has linked transactions you must supply replaceWithCategoryId to reassign them first, otherwise the call will fail. Cannot delete a parent category that still has subcategories. Check the transaction count with get_category_transaction_count first. Only call when the user explicitly confirms deletion. Requires finance:delete scope.
Inputs: categoryId (required), replaceWithCategoryId.
delete_payeeADestructiveInspect
Delete a Payee. Linked transactions retain their categoryId but their payeeId is set to null. Use cautiously — this is irreversible. Requires finance:delete scope.
Inputs: id (required), ignoreFuture.
delete_splitADestructiveInspect
Delete a single split from a transaction by its split ID (UUID string). DESTRUCTIVE: the split amount returns to the primary category. Fails if the split has refunds targeting it. Requires finance:delete scope.
Inputs: splitId (required).
delete_tagADestructiveInspect
Permanently delete a tag by ID. This is destructive — the tag will be removed and unlinked from all transactions. Only call when the user explicitly confirms deletion. Requires finance:delete scope.
Inputs: id (required).
delete_transactionADestructiveInspect
Move a transaction to Trash by ID. It is hidden everywhere and balances are reversed; the user can restore it in the app within 30 days, after which it is deleted for good. For transfer transactions, both sides of the transfer go to Trash. Rejected for transactions that belong to a payment, a portfolio or a venture: they must be unlinked first. Requires finance:delete scope.
Inputs: id (required).
get_accountARead-onlyInspect
Read one account: balances (original and base currency), opening balance, credit limit, category, status, bank link and logo, plus transactionCount, the number of transactions the account holds (null for an account shared with the user). Use it before update_account or delete_account.
Inputs: accountId (required).
get_accountsBRead-onlyInspect
List all user accounts with current balances. Returns account name, type, currency, current balance (in original and base currency), and credit limit.
Inputs: type, includeExcludedFromStats.
get_balance_historyARead-onlyInspect
Get account balance over time. If accountId is provided, returns balance history for that specific account. Otherwise, returns combined balance across all accounts.
Inputs: endDate, accountId, startDate.
get_cash_flowBRead-onlyInspect
Get income, expenses, and net cash flow for a period with configurable granularity (monthly/biweekly/weekly). Returns period-by-period breakdown plus totals with savings rate.
Inputs: endDate (required), startDate (required), accountId, categoryIds, +2 more.
get_categoriesARead-onlyInspect
List all transaction categories. Returns category ID, name, color, icon, type (income/expense), and parent ID for hierarchical categories.
Inputs: no named parameters.
get_category_transaction_countARead-onlyInspect
Count the transactions filed under a category, planned ones and split lines included. Call it before delete_category: a category with transactions can only be deleted with replaceWithCategoryId, and the count is the number that would be reassigned. A category that does not exist or is not yours (or shared with you) is not found.
Inputs: categoryId (required).
get_cumulative_statsARead-onlyInspect
Get running totals of expenses, income or savings by month for a period, next to the period of the same length right before it, plus the percent change, in the base currency. Use it for "am I spending more than last quarter so far".
Inputs: to (required), from (required), metric (required), tagIds, +7 more.
get_earliest_transaction_dateARead-onlyInspect
Get the date (YYYY-MM-DD) of the first transaction on record, or null when there are none. Planned future transactions do not count. Use it to pick a start date for the report tools.
Inputs: no named parameters.
get_expenses_for_periodARead-onlyInspect
Get total expense amount for a date range. Returns a single total number. Use this for quick "how much did I spend" queries instead of summing transactions manually.
Inputs: endDate, accountId, startDate, excludedCategoryIds.
get_net_worth_driversARead-onlyInspect
Explain what moved net worth, period by period, in the base currency: savings (income, expenses, net), investment growth (price effect, dividends, fees and taxes, per portfolio) and the holdings and cash values at the end of the period. A degraded field lists securities or currencies that could not be priced.
Inputs: to (required), from (required), granularity (required), portfolioIds.
get_net_worth_historyARead-onlyInspect
Get net worth over time as points, each with assets by kind (cash, investments, vehicles, ventures), liabilities by kind (credit-card, loan, overdraft) and the net worth, in the base currency. Subtracts credit limits when the includeCreditLimitInStats setting is on. A degraded field lists securities or currencies that could not be priced.
Inputs: to (required), from (required), granularity (required).
get_payeeARead-onlyInspect
Fetch a single Payee with aliases and computed stats. Useful when the user references a merchant by id and wants its full record.
Inputs: id (required).
get_payeesARead-onlyInspect
List Payees (merchants/counterparties) for the user, optionally filtered by a substring query. Returns Payee id, name, defaultCategoryId, and aggregated stats (transactionCount, netFlowRef, top category, last seen).
Inputs: q.
get_pivot_reportARead-onlyInspect
Cross-tab spending or income: rows by category, subcategory, payee or tag against time columns (yearly, quarterly, monthly, weekly), with row and column totals, in the base currency. Splits are distributed and refunds netted, so a refunded amount never counts as spend.
Inputs: to (required), from (required), measure (required), granularity (required), +4 more.
get_refund_linksARead-onlyInspect
List every refund link touching a transaction, on either side (as the refund or as the original). Each link has refundTxId, originalTxId (null for a purchase outside the app), splitId, and amount: the share of the refund transaction's amount in the refund's currency; null means the whole refund.
Inputs: transactionId (required).
get_refundsARead-onlyInspect
Read refund links, the pairs of an original transaction and the transaction that refunds it. Three modes: give transactionId for the refunds of one transaction; give originalTxId and refundTxId for one link; give neither (optionally page, limit, categoryId, accountId, transactionType) to list all of them, newest page first. Each link carries both transactions with their payee. Returns { refunds } and, in list mode, { meta: { total, page, limit } }. To find rows a refund could link to, use get_refund_recommendations (review toolset).
Inputs: page, limit, accountId, categoryId, +4 more.
get_spending_by_categoriesARead-onlyInspect
Get spending breakdown by category for a date range. Returns each category with its total amount. Great for understanding where money goes. Defaults to current month expenses.
Inputs: endDate, accountId, startDate, categoryIds, +2 more.
get_tagsARead-onlyInspect
List all user tags. Returns tag ID, name, color, and icon. Pass tagId to read one tag, which also includes its description.
Inputs: tagId.
get_total_balanceARead-onlyInspect
Get the user's total balance across all accounts on one date, as { amount, currencyCode, date }, where amount is a number in the base currency and currencyCode is that currency. Subtracts credit limits when the user's includeCreditLimitInStats setting is on. For a series over time use get_balance_history.
Inputs: date (required).
get_transaction_linksARead-onlyInspect
Read what a transaction is linked to: the portfolio transfer it funds or pays out (portfolioLink: portfolio, deposit or withdrawal, amount) and the venture event it belongs to (ventureLink: deal). Each is null when the transaction has no such link.
Inputs: transactionId (required).
get_transactions_by_idARead-onlyInspect
Read transactions by id (up to 50) or both legs of a transfer by transferId. Returns the same fields as search_transactions: amount (original + base currency), category, account, payee, note, date, type and planned state. Set includeSplits to also get splits, tags and, for a payment made from several accounts, its paymentParts. An id the caller cannot see is left out.
Inputs: ids, transferId, includeSplits.
get_transactions_summaryARead-onlyInspect
Count and totals of the transactions that match the filters, in the base currency: income, expense, net and transfers. Takes the same filters as the transaction list and as bulk_delete_transactions, so it previews what a bulk delete would remove. No default date range: omit from and to for the whole history.
Inputs: to, from, search, tagIds, +28 more.
get_user_profileARead-onlyInspect
Get the user's base currency, configured currencies with exchange rates, and basic profile info. Call this first to understand the user's currency context.
Inputs: no named parameters.
link_refundAInspect
Mark an existing transaction as a refund of another transaction. Provide originalTxId (the transaction being refunded) and refundTxId (the refund transaction). The two transactions must have opposite types (income vs expense). Optionally target a specific split of the original. One refund can cover several purchases: call once per purchase, each with an amount; the amounts cannot exceed the refund, and in the same currency the amounts against one purchase or split cannot exceed it. Requires finance:write scope.
Inputs: refundTxId (required), originalTxId (required), amount, splitId.
link_transferAInspect
Link two existing transactions as a transfer pair. The two transactions must be in different accounts and have opposite types (one income, one expense). Provide baseTxId (the source/expense side) and oppositeTxId (the destination/income side). Requires finance:write scope.
Inputs: baseTxId (required), oppositeTxId (required).
list_transaction_attachmentsARead-onlyInspect
List the files attached to a transaction (receipts, invoices): id, filename, mimeType, size in bytes and upload time. File bytes are not returned. Use the id with delete_attachment; create_attachment_upload_url adds files.
Inputs: transactionId (required).
merge_payeesADestructiveInspect
Merge a source Payee into a target Payee. Transactions and aliases move to the target; the target wins silently on defaultCategoryId conflict; the source is deleted. Use to dedupe near-duplicates like "Amazon" and "AMZN MKT". Requires finance:delete scope.
Inputs: sourceId (required), targetId (required).
remove_tags_from_transactionAInspect
Remove a tag from one or more transactions. Use when the user wants to untag transactions. Returns the count of removed tag links. Requires finance:write scope.
Inputs: tagId (required), transactionIds (required).
search_transactionsARead-onlyInspect
Search and filter transactions. Returns transaction amount (original + base currency), category, account, payee (payeeId and payee { id, name }), note, date, type, and tags. Filter by payee with payeeIds (get_payees resolves a name to an id) and by planned state with isPlanned. Use date filters to limit results. Default: last 30 days, 50 items; future plans need a later endDate.
Inputs: limit, order, offset, search, +12 more.
split_transactionAInspect
Split a transaction across multiple categories. Provide the transactionId and an array of splits whose amounts sum to the transaction total. Replaces any existing splits on the transaction. Requires finance:write scope.
Inputs: splits (required), transactionId (required).
unlink_refundAInspect
Remove one refund link, identified by refundTxId + originalTxId; both transactions stay. Other links on either transaction keep their shares, and a transaction is unmarked as refund-linked only when it has no links left. The link can be recreated with link_refund. Requires finance:write scope.
Inputs: refundTxId (required), originalTxId (required).
unlink_transferAInspect
Unlink transfer transactions by their shared transferId (UUID string). Both transactions in the pair will become independent income/expense entries. Use search_transactions to find the transferId of a linked pair. Requires finance:write scope.
Inputs: transferIds (required).
update_accountAInspect
Update an account: name, accountCategory, defaultPaymentType (null clears it), creditLimit, excludeFromStats, logo, and balances. currentBalance is allowed only on manual (system) accounts and moves the opening balance by the difference; initialBalance and currentBalance cannot be sent together. An account cannot be moved into or out of the vehicle category, or into loan. Amounts are decimals. Archiving is not done here: use archive_account. Requires finance:write scope.
Inputs: accountId (required), name, logoIcon, logoColor, +8 more.
update_categoryAInspect
Update an existing category by ID. Use when the user wants to rename, recolor, re-icon, move or set the default tags of a category. Returns the updated category records. Requires finance:write scope.
Inputs: categoryId (required), icon, name, color, +3 more.
update_payeeAInspect
Update a Payee. Leave a field out to keep it. Renaming preserves the previous canonical name as an alias so historical matches still resolve, and refuses a name another payee or alias already uses. Sets the default category and how it is applied (categorizationMode), the default tags and the default location for new transactions, and the logo (a brand domain or a monogram, not both; a logo set here is kept as manual). Returns the Payee. Requires finance:write scope.
Inputs: id (required), name, logoIcon, logoColor, +6 more.
update_tagAInspect
Update an existing tag by ID. Use when the user wants to rename, recolor, or change the icon/description of a tag. Returns the updated tag. Requires finance:write scope.
Inputs: id (required), icon, name, color, +1 more.
update_transactionAInspect
Update an existing transaction by ID. All fields except id are optional — only provide what you want to change. Pass tagIds: null to clear all tags, or tagIds: [] to do the same. Pass splits: null to clear all splits. Use payeeId to link an existing payee, or payeeId: null to clear it. Use originalAmount + originalCurrencyCode to record what the purchase cost in its invoice currency when that differs from the account currency. Use paymentLegs to change which accounts a multi-account payment is paid from. Requires finance:write scope.
Inputs: id (required), note, time, amount, +20 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Track expenses, budgets, balances, transfers, and multi-currency reports with OAuth-secured tools.
Personal finance for AI agents: accounts, budgets, goals, 9-strategy debt payoff, reports. OAuth 2.1
Personal finance: accounts, transactions, categories, budgets, goals, debts and spending stats.
Personal and small-business books: spending, US tax, bills. OAuth 2.1; never moves money.
1
Related MCP Servers
- AlicenseCqualityCmaintenanceEnables users to read and analyze personal financial data and perform operations such as managing transactions, accounts, categories, budgets, and reminders through the official API.33MIT
- AlicenseCqualityAmaintenanceopen-source personal finance app with a first-party MCP server. 91 HTTP tools (OAuth 2.1 + DCR) and 87 stdio tools cover transactions, budgets, accounts, portfolio analytics, FX conversion, loans, subscriptions, goals, importers, and rules. Users self-host with Docker + PostgreSQL or use the managed cloud8932AGPL 3.0
- FlicenseNot gradedqualityDmaintenanceExposes personal-finance tools like accounts, transactions, spending analysis, budgets, bills, reminders, portfolio, and goals via MCP, enabling any MCP client to query financial data.-
- AlicenseBqualityCmaintenanceEnables local-first personal finance management through deterministic tools for importing, categorizing, and analyzing bank transactions.36MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.