Monarch Money MCP Server
Use this server to read and manage Monarch Money finances through MCP, including accounts, transactions, budgets, recurring schedules, and spending analysis.
Read accounts, institutions, holdings, balance history, household members, categories, tags, merchants, recurring streams, savings goals, credit score, and net worth.
Fetch, search, filter, and paginate transactions by date, account, category, tag, attachment, notes, split, recurring, and pending status.
Create, update, bulk-update, delete, split, tag, and assign ownership on transactions; find possible duplicates.
Manage transaction automation rules, including applying them to existing transactions.
View budgets and cashflow; set category budgets and savings-goal monthly contributions.
Read and update merchant-wide recurring schedules and view forecast occurrences.
Create manual accounts, update account settings, and trigger account refreshes.
Analyze spending summaries and patterns, forecast trends, and get complete financial overviews.
Use typed structured results plus MCP resources, prompts, and natural-language dates.
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., "@Monarch Money MCP Server show my recent 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.
Monarch Money MCP Server
Use an AI assistant to read and update your Monarch Money accounts, transactions, and budgets through MCP.
Why this fork?
This rewrite adds these tools to colvint's original server:
Search and bulk edits:
search_transactionsfinds merchants or keywords;update_transactions_bulkedits up to 100 transactions per call, five at a time, with per-item results.Spending analysis:
get_spending_summarygroups totals by category, account, or month;analyze_spending_patternscompares months.One-call overview:
get_complete_financial_overviewcombines accounts, budgets, cashflow, transactions, and categories.Splits and recurring schedules: read and replace transaction splits, list every recurring stream with its next forecast, view scheduled occurrences, and edit merchant-wide recurrence.
Cleanup tools: find possible duplicates, delete transactions, merge merchants, and tag transactions.
Net worth and goals: daily net worth or monthly balances by account type, credit score history, and savings goals.
Unlike the original and keithah's enhanced Python fork, this server also provides:
Typed results: structured output with
outputSchema, plus a text fallback.MCP resources and prompts: account/category/institution resources, per-account holdings/history templates, and guided prompts with argument completion.
Assistant-friendly calls: compact transaction/category records, natural-language dates, read/write labels, and progress on batch analysis.
Comparison checked September 14, 2026. Other forks overlap on financial tools; the enhanced Python fork exposes a broader library API. This project focuses on analysis workflows and MCP integration, not exposing every API method. See the tool catalog.
Monarch also relaunched its own official MCP connector on October 21, 2026. It uses OAuth instead of your password, has weekly usage limits, and skips Finicity-connected accounts. Try it first if it covers what you need; this server runs locally and covers more write and analysis tools.
Related MCP server: Lunch Money MCP Server
Setup
Install uv, then configure your MCP client to run uvx monarch-mcp-jamiew. You'll need your Monarch email and password, plus an MFA secret for TOTP-based 2FA.
The latest release is on PyPI. Changes listed under Unreleased in the changelog need a source install until the next release.
Standard config
For clients with an mcpServers config:
{
"mcpServers": {
"monarch-money": {
"command": "uvx",
"args": ["monarch-mcp-jamiew"],
"env": {
"MONARCH_EMAIL": "your-email@example.com",
"MONARCH_PASSWORD": "your-password",
"MONARCH_MFA_SECRET": "your-mfa-secret-key"
}
}
}
}Add the monarch-money entry from the standard config to your config file's mcpServers object (create the file if needed):
macOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Then fully quit and reopen Claude Desktop.
claude mcp add monarch-money \
-e MONARCH_EMAIL=your-email@example.com \
-e MONARCH_PASSWORD=your-password \
-e MONARCH_MFA_SECRET=your-mfa-secret-key \
-- uvx monarch-mcp-jamiewAdd -s user to make it available across all your projects. Verify with claude mcp list.
codex mcp add monarch-money \
--env MONARCH_EMAIL=your-email@example.com \
--env MONARCH_PASSWORD=your-password \
--env MONARCH_MFA_SECRET=your-mfa-secret-key \
-- uvx monarch-mcp-jamiewOr add the equivalent block to ~/.codex/config.toml:
[mcp_servers.monarch-money]
command = "uvx"
args = ["monarch-mcp-jamiew"]
env = { MONARCH_EMAIL = "your-email@example.com", MONARCH_PASSWORD = "your-password", MONARCH_MFA_SECRET = "your-mfa-secret-key" }For Claude Code's project scope, save the standard config as .mcp.json in your project root. Keep credential-bearing files out of version control.
Add to ~/.hermes/config.yaml under mcp_servers:, then /reload-mcp (or restart Hermes):
mcp_servers:
monarch-money:
command: uvx
args: ["monarch-mcp-jamiew"]
env:
MONARCH_EMAIL: "your-email@example.com"
MONARCH_PASSWORD: "your-password"
MONARCH_MFA_SECRET: "your-mfa-secret-key"Add the standard config to ~/.openclaw/openclaw.json under mcpServers, then restart the gateway.
Set up a local stdio MCP server with command uvx, argument monarch-mcp-jamiew, and the credentials above. Follow your client's config format.
Not sure how? Tell your agent:
Install the Monarch Money MCP server from https://github.com/jamiew/monarch-mcp. The PyPI package is
monarch-mcp-jamiew, run viauvx monarch-mcp-jamiew. It needsMONARCH_EMAIL,MONARCH_PASSWORD, andMONARCH_MFA_SECRETfor TOTP-based 2FA.
Source installs use a pinned monarchmoneycommunity commit:
git clone https://github.com/jamiew/monarch-mcp
cd monarch-mcp
uv sync --lockedThen point your client at the local copy with absolute paths (find them with which uv and pwd):
{
"mcpServers": {
"monarch-money": {
"command": "/abs/path/to/uv",
"args": ["--directory", "/abs/path/to/monarch-mcp", "run", "python", "server.py"],
"env": {
"MONARCH_EMAIL": "your-email@example.com",
"MONARCH_PASSWORD": "your-password",
"MONARCH_MFA_SECRET": "your-mfa-secret-key"
}
}
}
}Theclaude mcp add and codex mcp add commands can save credentials in shell history. Edit the client's config directly to avoid that, and protect the config file.
Getting your MFA secret
Go to Monarch Money settings and enable 2FA
When shown the QR code, look for "Can't scan?" or "Enter manually"
Copy the TOTP secret key, not the rotating six-digit code
Use this as your
MONARCH_MFA_SECRET
Tools
The server exposes these 42 tools.
Tool | Description |
| List accounts with balances |
| Transactions with date/account/category, pending/posted, and needs-review filtering; returns |
| Search by merchant name or keyword, with the same filters and paging |
| Category list (compact by default) |
| Page through compact automation rules in priority order |
| Create a rule that matches merchant, statement text, or amount |
| Edit a rule, and optionally run it on past transactions |
| Delete a rule; transactions it already changed stay as they are |
| Household members and IDs for ownership updates |
| Create a manual transaction |
| Permanently delete a transaction |
| Update transaction fields or assign ownership |
| Update fields or owners with per-item success/failure |
| Read a transaction's splits |
| Resolve split parent and leg IDs; return split flags, category ID, and resolved transaction ID |
| Replace all splits; an empty list removes them |
| Budget data and spending analysis |
| Income and expense analysis |
| Investment holdings for an account (requires |
| Holdings grouped by brokerage account; excludes other account types |
| Paginated balance history with inclusive, locally applied ISO date bounds |
| Linked financial institutions |
| Scheduled occurrences within a date range |
| Every recurring stream with its merchant ID and next forecast |
| Change a merchant's recurring schedule |
| Page through merchants with transaction and rule counts |
| Delete a merchant, optionally moving its transactions to another merchant |
| List household tags |
| Create a tag |
| Replace a transaction's tags; an empty list removes them |
| Set a category's monthly budget, optionally for future months too |
| Savings goals with targets, balances, and progress |
| Set a goal's planned monthly contribution |
| Create a manually tracked account; valid types are in the |
| Rename an account, set its balance, or change net worth and visibility settings |
| Trigger account data refresh |
| Daily net worth, or monthly balances by account type |
| Household credit score snapshots |
| Possible duplicates: same date, amount, statement name, and account |
| Spending aggregated by category, account, or month, excluding transfers |
| Compact account, transaction, budget, and cashflow summaries; full sections opt-in |
| Monthly trends and a forecast from the last three complete months |
Spending totals skip transfers, such as credit card payments, so money moving between your own accounts isn't counted twice. Each result reports transfers_excluded.
Dates accept ISO dates or natural language. A month or year, such as 2024-02 or last month, covers the whole period: as an end_date it means the period's last day.
Use is_pending=True for pending transactions or False for posted ones; omit it
for both. Single and bulk updates accept owner_user_id from get_household_members.
An empty string sets Shared ownership; omitted/null leaves ownership unchanged.
Assignments override inherited ownership. Inspect ownedByUser with verbose=True;
the update response does not include it.
Rules default to 25 per page (maximum 100); history defaults to 100 (maximum 1,000).
Use limit, offset, and returned next_offset to continue; total_count covers all
matching records. Rule details remain available with verbose=True.
A rule can set a category, merchant name, tags, or review status. It can also hide transactions from reports. Each rule must look for a merchant name, statement text, or amount. Monarch ignores edits to rules that don't.
When you edit a rule, anything you leave out stays the same. To clear a value, pass
[] or "". Monarch replaces the whole rule on every edit, so the server sends back
the full rule with your changes. That keeps settings the tools can't edit, such as
owners, goals, and splits.
apply_to_existing_transactions=True also changes past transactions that match. That
is hard to undo, so check what matches with search_transactions first.
Overviews and spending analysis default to compact summaries; verbose=True restores
full sections. Transaction samples are capped at 500 and 2,000 respectively, even
in verbose mode. Check batch_metadata.transactions_truncated before treating
totals as complete; null means the upstream count was unavailable.
Recurring transactions
get_recurring_transactions(start_date, end_date) returns a forecast, not posted history.
Dates accept ISO or natural language. No dates selects this month; one date fills
the missing bound from that month. For the full list of recurring streams with each
merchant ID, use get_recurring_streams; active_only=False adds inactive ones.
Occurrences include stream, account, category, and a matched transactionId when
available. isPast does not mean paid. Use get_transactions(is_recurring=True)
for recorded transactions; do not count forecasts and posted matches twice.
update_recurring_transaction changes a merchant-wide schedule, not one occurrence.
Use stream.merchant.id, not stream.id or transactionId, and the current merchant
name to avoid renaming it. Pass only settings to change: frequency, base_date,
amount, is_recurring, or is_active. Omitted settings stay unchanged.
Use Monarch's frequency and signed amount. This does not cancel subscriptions,
move money, or create posted transactions.
Transaction format
get_transactions and search_transactions return compact records by default:
{
"id": "txn_123",
"date": "2025-03-15",
"amount": -12.50,
"merchant": "Corner Deli",
"plaidName": "CORNER DELI NYC",
"category": "Restaurants & Bars",
"categoryId": "cat_001",
"account": "Main Credit Card",
"needsReview": true
}pending appears only when true; notes appears only when nonempty. Set verbose=True on get_transactions or search_transactions for full transaction details, or on get_transaction_categories for full category details.
Session management
Sessions are cached in ~/.monarch-mcp/ for faster subsequent logins (override the location with the MONARCH_SESSION_DIR env var). If you hit auth issues:
Delete
~/.monarch-mcp/session.pickleto clear the cached sessionSet
MONARCH_FORCE_LOGIN=truein your env config to force a fresh loginMake sure your system clock is accurate (required for TOTP)
Development
Local setup
For live checks, create a .env file (git-ignored) and load it explicitly with uv --env-file:
MONARCH_EMAIL="your-email@example.com"
MONARCH_PASSWORD="your-password"
MONARCH_MFA_SECRET="YOUR_TOTP_SECRET_KEY"Tests
uv run pytest tests/ -v # offline; live tests are skipped
MONARCH_RUN_INTEGRATION=true uv run --env-file .env pytest tests/test_integration.py -v
uv run --env-file .env scripts/health_check.py # live API connectivity checkIntegration tests share one fresh login to avoid MFA reuse and login throttling. They never load .env themselves or read/write saved sessions.
CI checks
Run the same checks as CI:
uv run python scripts/ci.pyReleasing
Use /release to bump pyproject.toml, commit, tag vX.Y.Z, push, and create a GitHub release. The publish workflow publishes to PyPI and the MCP Registry through OIDC, setting server.json versions from the tag.
Log analysis
Measure tool calls and timing. Output sizes need MONARCH_LOG_RESULT_SIZE=true in the server's env, since measuring serializes each result a second time.
uv run scripts/analyze_logs.py # full report
uv run scripts/analyze_logs.py --json # JSON output
uv run scripts/eval_session.py snapshot # mark log position
# ... use tools in Claude ...
uv run scripts/eval_session.py analyze # analyze new entriesSecurity
Warning: This server uses unofficial Monarch Money API access. Your credentials grant full account access, including writes.
The server runs locally and returns requested financial data to your MCP client. Review the client's privacy settings and tool approvals.
Protect your password and MFA secret. The TOTP secret enables ongoing code generation.
Session files in
~/.monarch-mcp/contain auth tokens. Protect them and any customMONARCH_SESSION_DIR.Logs can include financial input values and error details. Review them before sharing.
Never commit credential-bearing
.env,.mcp.json, or client config files.Monarch Money may change or restrict unofficial API access at any time.
Credits
Forked from colvint/monarch-money-mcp. API access uses bradleyseanf/monarchmoneycommunity, based on hammem/monarchmoney. Source installs pin a commit; PyPI installs use the published library.
Contributors: @caseypugh (transaction splits), @seanperkins (spending summary pagination), @rajatbhagat (setup docs), @samyk (transaction rules), and @prerak-proof (transaction details).
Available Tools
42 toolsanalyze_spending_patternsAnalyze Spending PatternsARead-only
Summarize monthly trends, category expenses, account usage, and budget data.
Args: lookback_months: Months before today to include (default: 6). include_forecasting: Include average-based income and expense estimates. verbose: Include full budget details instead of monthly budget totals.
Requests one page of up to 2000 transactions, without pagination; analysis can be incomplete for larger periods. Transfers such as card payments are left out of every section and counted in metadata.transfers_excluded (null when categories could not be read). Forecasts average the latest three complete calendar months with transactions, excluding the current month. The confidence label is fixed, not a statistical measure. Failed transaction, category, or budget requests appear in errors; successful analysis sections remain available. metadata.transactions_truncated reports whether more transactions exist (null when unknown). Fetch narrower date ranges with get_transactions for detail.
Inputs: verbose, lookback_months, include_forecasting. Returns: errors, verbose, forecast, metadata, +5 more
create_manual_accountCreate Manual AccountA
Create a manually tracked account and return its new ID.
Args: account_name: Display name for the account. account_type: Monarch account type name, such as loan, other_asset, or other_liability. The accounts://types resource lists valid types and subtypes. account_sub_type: Subtype name within that type, such as mortgage, auto, or line_of_credit. balance: Starting balance. include_in_net_worth: Whether the account counts toward net worth.
Inputs: balance (required), account_name (required), account_type (required), account_sub_type (required), +1 more. Returns: account
create_transactionCreate TransactionA
Create a manual transaction.
Args: amount: Positive for income, negative for an expense. merchant_name: Merchant/payee display name. account_id: Account ID from get_accounts. date: Transaction date in YYYY-MM-DD format. category_id: Required category ID from get_transaction_categories. notes: Optional memo. update_balance: False records the transaction without changing the account balance. True also adjusts the balance, useful for manual accounts.
Returns the created transaction details.
Inputs: date (required), amount (required), account_id (required), category_id (required), +3 more. Returns: transaction
create_transaction_ruleCreate Transaction RuleADestructive
Create an automation rule.
A rule needs at least one action and a merchant, statement, or amount criterion. Without one of those three, Monarch ignores later edits to the rule.
Criteria (a transaction must match all of them; values in one list are "or"): merchant_criteria: Merchant name text, e.g. [{"operator": "contains", "value": "Corner Deli"}]. original_statement_criteria: Bank statement text, same shape. amount_criteria: {"operator": "gt"|"lt"|"eq", "value": 20} or {"operator": "between", "lower": 10, "upper": 50}. Amounts have no sign. is_expense=True (the default) matches money going out; False matches money coming in. account_ids / category_ids: Only match these accounts or current categories.
Actions: set_category_id: Category ID from get_transaction_categories. set_merchant_name: New merchant name (a name, not an ID). add_tag_ids: Tag IDs to add. hide_from_reports: Hide matching transactions from reports. review_status: "needs_review" or "reviewed".
apply_to_existing_transactions=True also changes matching past transactions right away. That is hard to undo, so check the criteria with search_transactions first. This tool does not change rule priority.
Inputs: account_ids, add_tag_ids, category_ids, review_status, +7 more. Returns: rule, applied_to_existing_transactions
create_transaction_tagCreate Transaction TagB
Create a household transaction tag and return it with its new ID.
Args: name: Tag name. color: Hex color as #RRGGBB.
Inputs: name (required), color. Returns: tag
delete_merchantDelete MerchantADestructiveIdempotent
Delete a merchant; irreversible.
Args: merchant_id: Merchant ID from get_merchants. move_to_merchant_id: Optional merchant ID from get_merchants. Moving merges the deleted merchant's transactions into this merchant.
Inputs: merchant_id (required), move_to_merchant_id. Returns: deleted, merchant_id, move_to_merchant_id
delete_transactionDelete TransactionADestructiveIdempotent
Permanently delete a transaction by ID from get_transactions or find_duplicate_transactions.
Inputs: transaction_id (required). Returns: deleted, transaction_id
delete_transaction_ruleDelete Transaction RuleADestructiveIdempotent
Delete an automation rule by ID from get_transaction_rules.
Transactions the rule already changed keep their current values. Deletion is confirmed by reading the rule list again.
Inputs: rule_id (required). Returns: deleted, rule_id
find_duplicate_transactionsFind Duplicate TransactionsARead-only
Find possible duplicate transactions: same date, amount, statement name, and account.
Args: start_date: Inclusive start; ISO or natural language. Defaults to 90 days before end_date. end_date: Inclusive end. Defaults to today. account_id: Optional account ID from get_accounts.
Groups are possible duplicates only; review before deleting. Each group lists compact transactions oldest first. Hidden transactions and rows without a statement name are skipped. scan_truncated is true when the range holds more transactions than one scan reads; narrow the dates or account then.
Inputs: end_date, account_id, start_date. Returns: count, groups, end_date, start_date, +2 more
get_account_historyGet Account HistoryARead-only
Get a page of balance history for account_id from get_accounts.
Optional YYYY-MM-DD bounds are inclusive; an omitted bound is unbounded. Filtering precedes local paging, preserving Monarch's snapshot order. limit: 1–1000 (default 100); offset: zero-based position after filtering. Follow next_offset until null. total_count counts all matching snapshots. Monarch still returns the full history upstream; the MCP response is bounded.
Inputs: account_id (required), limit, offset, end_date, +1 more. Returns: count, offset, history, account_id, +2 more
get_account_holdingsGet Account HoldingsARead-only
Get investment holdings for an account_id from get_accounts.
Inputs: account_id (required). Returns: holdings
get_accountsGet AccountsARead-only
Retrieve all linked financial accounts.
Inputs: no named parameters. Returns: count, accounts
get_all_holdingsGet All Brokerage HoldingsARead-only
Get holdings grouped by brokerage account, not all asset classes.
Fetches accounts, then holdings for each brokerage account concurrently. A failed account request fails the entire call; this is not a single API request.
Inputs: no named parameters. Returns: accounts
get_budgetsGet BudgetsARead-only
Retrieve budgets for optional start_date/end_date filters.
Dates accept ISO strings or natural language such as 'last month'. A missing end defaults to today; a missing start to the first day of the end date's month.
Inputs: end_date, start_date. Returns: budgets, message
get_cashflowGet CashflowARead-only
Retrieve cash flow for optional start_date/end_date filters.
Dates accept ISO strings or natural language such as 'last month'. A missing end defaults to today; a missing start to the first day of the end date's month.
Inputs: end_date, start_date. Returns: cashflow
get_complete_financial_overviewComplete Financial OverviewARead-only
Fetch a compact financial overview; verbose=True includes full API details.
period is a start date or phrase such as 'this month', 'last month', or 'this year'; the end is always today. 'last month' therefore includes the current month too. Transactions and their summary use one page of up to 500 entries, not the full history. Failed API sections contain errors while successful sections remain. Default: account IDs/names/balances/types, monthly budget totals, cashflow totals, and a transaction summary. Raw transactions/categories are null unless verbose. Use their dedicated tools for details. batch_metadata.transactions_truncated is true if more transactions exist, false for a complete page, null if unknown. Summary income and expenses leave out transfers such as card payments; transfers_excluded counts them, or is null when categories could not be read.
Inputs: period, verbose. Returns: period, budgets, verbose, accounts, +5 more
get_credit_score_historyGet Credit Score HistoryARead-only
Get household credit score snapshots, oldest first.
Returns enrolled (whether credit monitoring is set up), users [{id, name}], and snapshots [{date, score, user_id}]; user_id matches a users entry.
Inputs: no named parameters. Returns: count, users, enrolled, snapshots
get_household_membersGet Household MembersARead-only
List current household members and IDs for transaction ownership.
Pending invitations are excluded. Use an ID as owner_user_id in transaction updates, or "" for Shared; a missing/null owner_user_id leaves it unchanged.
Inputs: no named parameters. Returns: count, members
get_institutionsGet InstitutionsARead-only
Get linked financial institutions.
Inputs: no named parameters. Returns: institutions
get_merchantsGet MerchantsARead-only
List a page of merchants with transaction and rule counts.
Args: limit: 1–500 (default 100). offset: Zero-based position. Follow next_offset until null. verbose: True returns the full upstream objects.
Compact rows: id, name, transaction_count, rule_count, has_active_recurring_streams, can_be_deleted. Merchant IDs feed delete_merchant. total_count is Monarch's merchantCount, which may count a different set than the list; rely on next_offset.
Inputs: limit, offset, verbose. Returns: count, offset, verbose, merchants, +2 more
get_net_worth_historyGet Net Worth HistoryARead-only
Get net worth over time: daily totals, or monthly balances per account type.
Args: start_date: Inclusive start; ISO or natural language. Defaults to one year ago. end_date: Inclusive end. Defaults to today. by_account_type: False returns daily {date, balance} totals across all accounts. True returns monthly {month, account_type, balance} rows plus account_types with each type's group (asset or liability).
Inputs: end_date, start_date, by_account_type. Returns: count, history, end_date, start_date, +2 more
get_recurring_streamsGet Recurring StreamsARead-only
List every recurring stream (merchant schedule) with its next forecast.
Args: active_only: True skips paused streams. include_liabilities: True includes credit-report liability streams such as loans and cards. verbose: True returns the full upstream objects.
Compact rows: id, name, merchant {id, name}, frequency, amount, is_approximate, is_active, review_status, recurring_type, base_date, next_date, next_amount, category, category_id, account, account_id. merchant.id and merchant.name feed update_recurring_transaction. Forecasts are expectations, not posted transactions.
Inputs: verbose, active_only, include_liabilities. Returns: count, streams, verbose
get_recurring_transactionsGet Recurring TransactionsARead-only
Get scheduled recurring occurrences, not the posted transaction history.
Dates accept ISO dates or natural language such as "today" or "last month". With neither date, fetch the current calendar month. With only a start, end on that month's last day. With only an end, start on the first day of that period.
The recurring.recurringTransactionItems list includes each occurrence's date, amount, account, category, transactionId (when matched), and stream containing the merchant ID, frequency, and expected amount. isPast describes the date, not whether a bill was paid. Use get_transactions(is_recurring=True) for recorded transactions instead. Use get_recurring_streams for the full list of streams.
Inputs: end_date, start_date. Returns: recurring
get_savings_goalsGet Savings GoalsARead-only
List savings goals with targets, balances, and progress.
Args: include_archived: True also returns archived goals. verbose: True returns the full upstream objects.
Compact goals keep whichever of these fields Monarch returns: id, name, type, status, targetAmount, currentBalance, progress, targetDate, plannedMonthlyContribution, forecastedCompletionDate, archivedAt. Goal IDs feed set_savings_goal_budget_amount.
Inputs: verbose, include_archived. Returns: count, goals, verbose
get_spending_summaryGet Spending SummaryARead-only
Summarize income, expenses, and net by category, account, or month.
Args: start_date: Inclusive start; accepts ISO dates or natural language. end_date: Inclusive end; accepts the same formats. A missing end defaults to today; a missing start to the first day of the end date's month. group_by: 'category', 'account', or 'month'; other values produce one group.
Fetches all matching pages. Expenses are positive magnitudes. Transfers (categories in Monarch's transfer group, such as credit card payments) are left out and counted in transfers_excluded. period holds the resolved ISO dates.
Inputs: end_date, group_by, start_date. Returns: groups, period, totals, group_by, +1 more
get_transaction_categoriesGet Transaction CategoriesARead-only
List category IDs and names for lookups and transaction updates.
verbose=True preserves full API details, including groups and system flags. Returns categories, count, and verbose.
Inputs: verbose. Returns: count, verbose, categories
get_transaction_detailsGet Transaction DetailsARead-only
Get one transaction's split linkage, amount, merchant, and category_id.
Compact get_transactions/search_transactions results omit split flags. Verbose results identify split legs with isSplitTransaction but do not expose their parent IDs. This tool returns a leg's parent_transaction_id or a parent's has_split_transactions flag and split_transaction_ids. Use these IDs to fetch details for individual legs; an unsplit transaction or a split leg returns an empty list.
Use this before get_transaction_splits or update_transaction_splits when you need the parent ID. transaction_id is the resolved ID returned by Monarch; it may differ from the requested ID when a pending transaction redirects to its posted replacement. Missing transactions raise an error.
Inputs: transaction_id (required). Returns: amount, merchant, category_id, transaction_id, +4 more
get_transaction_rulesGet Transaction RulesARead-only
Read a page of automation rules in priority order, without modifying them.
limit: 1–100 (default 25); offset: zero-based position. Follow next_offset until null; count is this page and total_count is all rules. Paging is local. Compact results omit null/empty object fields and GraphQL type labels, but preserve false, zero, and active criteria/actions. verbose=True returns the full upstream objects for the requested page.
Inputs: limit, offset, verbose. Returns: count, rules, offset, verbose, +2 more
get_transactionsGet TransactionsARead-only
Fetch one page of transactions.
Args: limit: Maximum transactions to request (default: 100). offset: Transactions to skip for pagination. start_date: Inclusive start; accepts ISO dates, 'last month', or '30 days ago'. Without end_date, the end defaults to today. end_date: Inclusive end, with the same date formats. Without start_date, the start defaults to the first day of the end date's month. account_id: Account ID from get_accounts. category_id: Category ID from get_transaction_categories. tag_ids: Comma-separated tag IDs. has_attachments: True for transactions with attachments, False for those without. has_notes: True for transactions with notes, False for those without. hidden_from_reports: True for hidden transactions, False for visible ones. is_split: True for split transactions, False for non-split transactions. is_recurring: True for recurring transactions, False for non-recurring ones. is_pending: True for pending transactions, False for posted transactions. needs_review: True for transactions flagged for review, False for reviewed ones. verbose: False returns compact fields; True preserves the full API objects.
Boolean filters default to None (no restriction). Results contain transactions, count (this page), total_count (all matches; null if Monarch omits it), and next_offset (null when no more pages). Pass next_offset as offset for the next page.
Compact fields: id, date, amount, merchant, plaidName, category, categoryId, account, needsReview; pending appears only when true, notes only when nonempty, tags (tag names) only when the transaction has tags. Amounts are negative for expenses and positive for income. Use id for updates. merchant is the display name; plaidName preserves the original statement text. category and account are names, not nested objects.
Verbose results retain nested merchant/category/account objects and upstream fields such as hideFromReports, reviewStatus, isSplitTransaction, isRecurring, attachments, tags, and timestamps.
Inputs: limit, offset, tag_ids, verbose, +11 more. Returns: count, verbose, next_offset, total_count, +1 more
get_transaction_splitsGet Transaction SplitsARead-only
Get split legs for transaction_id from get_transactions or search_transactions.
Returns transaction_id, has_split_transactions, and splits with each leg's amount, category, merchant, and notes. An unsplit transaction has an empty list.
Inputs: transaction_id (required). Returns: splits, transaction_id, has_split_transactions
get_transaction_tagsGet Transaction TagsARead-only
List household transaction tags: id, name, color, transaction_count.
Tag IDs feed set_transaction_tags and the tag_ids filter of get_transactions.
Inputs: no named parameters. Returns: tags, count
refresh_accountsRefresh AccountsA
Request an institution refresh for all accounts; do not wait for completion.
Inputs: no named parameters. Returns: result
search_transactionsSearch TransactionsARead-only
Search one page of transactions using Monarch's text search.
Args: query: Nonempty search text for Monarch's transaction search. limit: Maximum transactions to request (default: 500). offset: Transactions to skip for pagination. start_date: Inclusive start, accepting ISO dates or natural language. Without end_date, the end defaults to today. end_date: Inclusive end. Without start_date, the start defaults to the first day of the end date's month. account_id: Account ID from get_accounts. category_id: Category ID from get_transaction_categories. tag_ids: Comma-separated tag IDs. has_attachments: Filter by attachment presence. has_notes: Filter by notes presence. hidden_from_reports: True for hidden transactions, False for visible ones. is_split: Filter by split status. is_recurring: Filter by recurring status. is_pending: True for pending transactions, False for posted transactions. needs_review: True for transactions flagged for review, False for reviewed ones. verbose: False uses get_transactions' compact fields; True keeps full API objects.
Boolean filters default to None (no restriction). Returns matching transactions, search_metadata with the query, this page's result_count, and applied filters, plus total_count (all matches; null if Monarch omits it) and next_offset (null when no more pages). Pass next_offset as offset for the next page.
Inputs: query (required), limit, offset, tag_ids, +12 more. Returns: next_offset, total_count, transactions, search_metadata
set_budget_amountSet Budget AmountAIdempotent
Set a category's monthly budget amount.
Args: category_id: Category ID from get_transaction_categories. amount: Budget amount; 0 clears the budget for that month. month: Any date in the target month; ISO or natural language. Defaults to the current month. apply_to_future: True also applies the amount to later months.
Inputs: amount (required), category_id (required), month, apply_to_future. Returns: month, amount, result, category_id, +1 more
set_savings_goal_budget_amountSet Savings Goal Budget AmountAIdempotent
Set a savings goal's planned monthly contribution.
Args: goal_id: Goal ID from get_savings_goals. amount: Planned contribution for the month. month: Any date in the target month; ISO or natural language. Defaults to the current month. apply_to_future: True also applies the amount to later months.
Inputs: amount (required), goal_id (required), month, apply_to_future. Returns: month, amount, goal_id, apply_to_future
set_transaction_tagsSet Transaction TagsAIdempotent
Replace all tags on a transaction; [] removes every tag. Returns the resulting tag IDs.
Args: transaction_id: Transaction ID from get_transactions or search_transactions. tag_ids: The complete tag list, as IDs from get_transaction_tags.
Inputs: tag_ids (required), transaction_id (required). Returns: tag_ids, transaction_id
update_accountUpdate AccountAIdempotent
Update an account's settings, leaving omitted fields unchanged.
Args: account_id: Account ID from get_accounts. name: New display name. balance: New balance; meant for manual accounts, since synced accounts refresh theirs. include_in_net_worth: Whether the account counts toward net worth. hide_from_summary_list: Whether to hide the account from the accounts list. hide_transactions_from_reports: Whether to exclude its transactions from budgets and reports.
Provide at least one change. Returns the compact updated account.
Inputs: account_id (required), name, balance, include_in_net_worth, +2 more. Returns: account
update_recurring_transactionUpdate Recurring TransactionAIdempotent
Change a merchant's recurring schedule, not an individual transaction.
This affects the merchant-wide recurrence. Get merchant_id from an occurrence's stream.merchant.id, not stream.id or transactionId. Pass the current merchant_name to avoid renaming the merchant.
Omitted settings stay unchanged; provide at least one. is_recurring enables or removes recurrence; is_active pauses or resumes a schedule. frequency is Monarch's string (for example, "monthly"). base_date is the schedule's anchor date and accepts the same date formats as get_recurring_transactions. amount uses Monarch's signed amount, as returned by the existing stream. This does not create posted transactions or move money.
Inputs: merchant_id (required), merchant_name (required), amount, base_date, +3 more. Returns: merchant
update_transactionUpdate TransactionAIdempotent
Update a transaction, leaving omitted fields unchanged.
Args: transaction_id: Transaction ID from get_transactions or search_transactions. amount: New nonzero amount. Monarch's client cannot set an amount of 0. merchant_name: New display name, not the read-only plaidName statement text. The API ignores empty names. category_id: New category ID from get_transaction_categories. date: New date in YYYY-MM-DD format. notes: Memo, separate from the merchant name; "" clears it. goal_id: Savings goal ID; "" clears the association. hide_from_reports: Whether to hide the transaction from reports. needs_review: Whether to flag the transaction for review. owner_user_id: Member ID from get_household_members; "" makes it Shared. Omitted/null leaves ownership unchanged. Read verbose transactions to verify ownership; the update response does not include the owner.
Returns updated transaction details. This tool cannot change the transaction ID, account, pending status, attachments, or timestamps. Use update_transaction_splits to change splits and update_recurring_transaction to change a merchant's recurring schedule.
Inputs: transaction_id (required), date, notes, amount, +6 more. Returns: transaction
update_transaction_ruleUpdate Transaction RuleADestructiveIdempotent
Edit a rule, and optionally run it on existing transactions.
Get rule_id from get_transaction_rules. Arguments you leave out keep their current value. To clear a value, pass [] for a list or "" for set_category_id, set_merchant_name, or review_status. clear_amount_criteria removes the amount criterion. A list replaces the whole old list. Shapes match create_transaction_rule.
Monarch replaces the whole rule on update. So this reads the rule first and sends it back with your changes, which keeps settings this tool can't edit, such as owners, goals, and splits. The edited rule must keep at least one action and a merchant, statement, or amount criterion.
apply_to_existing_transactions=True runs the rule on matching past transactions, even with no other changes. That is hard to undo.
Inputs: rule_id (required), account_ids, add_tag_ids, category_ids, +9 more. Returns: rule, applied_to_existing_transactions
update_transactions_bulkBulk Update TransactionsAIdempotent
Update transactions concurrently, returning per-item results and counts.
Args: updates: JSON array encoded as a string. Each item requires a nonempty transaction_id and accepts amount, merchant_name, category_id, date (YYYY-MM-DD), notes, goal_id, hide_from_reports, needs_review, and owner_user_id. Fields have the same meaning as update_transaction; omitted/null fields stay unchanged. Empty notes or goal_id clears that value; empty owner_user_id makes the transaction Shared.
Items reject unknown fields and wrong types without coercion; amounts must be finite nonzero numbers and flags must be booleans. Invalid items fail individually; valid items still run. The batch is not atomic and does not roll back successes.
Example: [{"transaction_id": "txn_123", "category_id": "cat_456", "notes": ""}, {"transaction_id": "txn_789", "needs_review": false}]
Inputs: updates (required). Returns: message, results, summary
update_transaction_splitsUpdate Transaction SplitsBIdempotent
Replace a transaction's entire set of splits, or remove all splits with [].
Args: transaction_id: Parent transaction ID. For a split leg from list/search, resolve parent_transaction_id with get_transaction_details first. splits: Complete replacement list. Each leg accepts: - amount (required): Negative for expenses, positive for income. Amounts must sum to the parent's amount or Monarch rejects the update. - category_id: Category ID for the leg. - merchant_name: Display name; defaults to the parent merchant. - notes: Per-leg memo.
Example for a -100.00 parent transaction: [{"amount": -70.00, "category_id": "cat_groceries", "notes": "Food"}, {"amount": -30.00, "category_id": "cat_household"}]
Returns transaction_id, has_split_transactions, resulting splits, and a summary.
Inputs: splits (required), transaction_id (required). Returns: splits, message, transaction_id, has_split_transactions
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 42 tools
Most tools target distinct resource-action pairs, but the reporting surface is crowded: get_spending_summary, analyze_spending_patterns, get_complete_financial_overview, and get_cashflow all summarize financial activity and could be misselected for similar questions. Descriptions give guidance, so it is manageable but not fully unambiguous.
All tool names use snake_case with a consistent verb_noun structure such as get_transactions, create_transaction_rule, update_account, and delete_merchant. Longer names like set_savings_goal_budget_amount still follow the same predictable pattern.
At 42 tools, the server is well above the 3–15 scoped range and the 25+ threshold for 'too many.' The breadth of Monarch's domain partly justifies the surface, but the count creates a large selection burden and includes several near-duplicate reporting tools.
Core transaction, account, budget, recurring, rule, and tag workflows are well covered, including transaction CRUD, bulk updates, splits, and rule CRUD. Minor gaps remain around tag lifecycle (no update/delete tag), savings-goal lifecycle (only budget amount), and some account/category lifecycle operations, but these are mostly workaroundable.
Maintenance
Related MCP Connectors
Personal finance for AI agents — onboard, import statements, categorize & budget over MCP.
An MCP server that integrates with Discord to provide AI-powered features.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Read-only finance MCP server. Connects your banks, cards, payment apps, books and payroll into one ledger for your AI. Can't move money. Open source (AGPL-3.0), free during beta.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server that provides access to personal financial data from Monarch Money, allowing users to retrieve account information, transactions, budgets, goals, and net worth through natural language queries.16-
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to interact directly with Lunch Money's financial API, allowing users to query transactions, access budget information, and perform financial analysis through natural language.-
- FlicenseNot gradedqualityDmaintenanceAn MCP server that integrates with Monarch Money to provide financial data access and operations, including account management, transaction filtering, budget analysis, and goal tracking through natural language.-
- AlicenseAqualityDmaintenanceMCP server providing 30 tools to access and manage Monarch Money financial data, including accounts, transactions, budgets, and more, enabling AI assistants to interact with personal finances.3046 npm2MIT