Skip to main content
Glama

Server Details

Personal finance tracker: accounts, transactions, budgets, investments and analytics over OAuth.

Ownership verified
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

A3.7/5.0

Scored across 56 tools

Disambiguation3/5

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.

Naming Consistency5/5

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.

Tool Count3/5

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.

Completeness4/5

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
Privacy policy
Not provided
Trust center
Not applicable
Restrictions
Cloud is under subscription, self-hosted is free · Publisher source

Available Tools

56 tools
adjust_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_payeesA
Destructive
Inspect

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_transactionsA
Destructive
Inspect

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_accountA
Destructive
Inspect

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_attachmentA
Destructive
Inspect

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_categoryA
Destructive
Inspect

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_payeeA
Destructive
Inspect

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_splitA
Destructive
Inspect

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_tagA
Destructive
Inspect

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_transactionA
Destructive
Inspect

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_accountA
Read-only
Inspect

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_accountsB
Read-only
Inspect

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_historyA
Read-only
Inspect

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_flowB
Read-only
Inspect

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_categoriesA
Read-only
Inspect

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_countA
Read-only
Inspect

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_statsA
Read-only
Inspect

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_dateA
Read-only
Inspect

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_periodA
Read-only
Inspect

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_driversA
Read-only
Inspect

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_historyA
Read-only
Inspect

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_payeeA
Read-only
Inspect

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_payeesA
Read-only
Inspect

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_reportA
Read-only
Inspect

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_refundsA
Read-only
Inspect

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_categoriesA
Read-only
Inspect

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_tagsA
Read-only
Inspect

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_balanceA
Read-only
Inspect

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_transactions_by_idA
Read-only
Inspect

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_summaryA
Read-only
Inspect

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_profileA
Read-only
Inspect

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.

list_transaction_attachmentsA
Read-only
Inspect

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_payeesA
Destructive
Inspect

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_transactionsA
Read-only
Inspect

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).

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

    Related MCP Servers

    • A
      license
      C
      quality
      C
      maintenance
      Enables users to read and analyze personal financial data and perform operations such as managing transactions, accounts, categories, budgets, and reminders through the official API.
      33
      MIT
    • A
      license
      C
      quality
      A
      maintenance
      open-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 cloud
      89
      32
      AGPL 3.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      Exposes personal-finance tools like accounts, transactions, spending analysis, budgets, bills, reminders, portfolio, and goals via MCP, enabling any MCP client to query financial data.
      -
    • A
      license
      B
      quality
      C
      maintenance
      Enables local-first personal finance management through deterministic tools for importing, categorizing, and analyzing bank transactions.
      36
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.