Monarch MCP Server

io.github.jamiew由 GitHub 帳號 jamiew 發布v0.7.1更新於 Nov 11, 2026

Query and update Monarch Money accounts, transactions, and budgets

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

讓助理連接 Monarch Money 帳戶,讀取並修改帳戶、交易、預算、持倉與淨資產。

可以做什麼
  • 讀取帳戶、金融機構、餘額歷史、持倉、淨資產歷史、信用分數與儲蓄目標
  • 列出、搜尋、新增、修改、批次編輯、拆分、加標籤和刪除交易,並找出疑似重複項目
  • 讀取與設定預算、現金流、支出彙總和支出模式分析
  • 讀取、新增、編輯和刪除交易自動化規則;列出並修改週期性帳單與預定發生項目
  • 新增和更新手動帳戶、商家與家庭標籤
適用情境
適合讓助理回答關於自己 Monarch Money 資料的問題,或在不逐筆點選應用的情況下做批次清理與分類調整。適合已在使用 Monarch、且需要比官方連接器更多寫入與分析工具的使用者。
執行需求
以 stdio 本機程序執行,透過 uvx(需安裝 uv)或從原始碼啟動。需要 Monarch Money 帳戶,以及環境變數 MONARCH_EMAIL、MONARCH_PASSWORD 和 MONARCH_MFA_SECRET(TOTP 密鑰,不是動態驗證碼),並需要網路存取。工作階段快取預設存放在 ~/.monarch-mcp。
安裝前請注意
使用非官方 API 存取,憑證擁有包含寫入在內的完整帳戶權限。TOTP 密鑰可長期產生驗證碼,工作階段快取檔含驗證權杖。工具可永久刪除交易、規則和商家,替換拆分與標籤,並把規則套用到歷史交易。日誌可能包含財務資料。不要把憑證寫入 shell 歷史或版本控制。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Monarch MCP Server,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

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_transactions finds merchants or keywords; update_transactions_bulk edits up to 100 transactions per call, five at a time, with per-item results.
  • Spending analysis: get_spending_summary groups totals by category, account, or month; analyze_spending_patterns compares months.
  • One-call overview: get_complete_financial_overview combines 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.

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:

json
{  "mcpServers": {    "monarch-money": {      "command": "uvx",      "args": ["monarch-mcp-jamiew"],      "env": {        "MONARCH_EMAIL": "[email protected]",        "MONARCH_PASSWORD": "your-password",        "MONARCH_MFA_SECRET": "your-mfa-secret-key"      }    }  }}
Claude Desktop

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.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Then fully quit and reopen Claude Desktop.

Claude Code
bash
claude mcp add monarch-money \  -e [email protected] \  -e MONARCH_PASSWORD=your-password \  -e MONARCH_MFA_SECRET=your-mfa-secret-key \  -- uvx monarch-mcp-jamiew

Add -s user to make it available across all your projects. Verify with claude mcp list.

Codex CLI
bash
codex mcp add monarch-money \  --env [email protected] \  --env MONARCH_PASSWORD=your-password \  --env MONARCH_MFA_SECRET=your-mfa-secret-key \  -- uvx monarch-mcp-jamiew

Or add the equivalent block to ~/.codex/config.toml:

toml
[mcp_servers.monarch-money]command = "uvx"args = ["monarch-mcp-jamiew"]env = { MONARCH_EMAIL = "[email protected]", MONARCH_PASSWORD = "your-password", MONARCH_MFA_SECRET = "your-mfa-secret-key" }
.mcp.json (project-scoped)

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.

Hermes

Add to ~/.hermes/config.yaml under mcp_servers:, then /reload-mcp (or restart Hermes):

yaml
mcp_servers:  monarch-money:    command: uvx    args: ["monarch-mcp-jamiew"]    env:      MONARCH_EMAIL: "[email protected]"      MONARCH_PASSWORD: "your-password"      MONARCH_MFA_SECRET: "your-mfa-secret-key"
OpenClaw

Add the standard config to ~/.openclaw/openclaw.json under mcpServers, then restart the gateway.

Any other MCP client (Cursor, VS Code, Windsurf, Cline, Zed, …)

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 via uvx monarch-mcp-jamiew. It needs MONARCH_EMAIL, MONARCH_PASSWORD, and MONARCH_MFA_SECRET for TOTP-based 2FA.

From source (development)

Source installs use a pinned monarchmoneycommunity commit:

bash
git clone https://github.com/jamiew/monarch-mcpcd monarch-mcpuv sync --locked

Then point your client at the local copy with absolute paths (find them with which uv and pwd):

json
{  "mcpServers": {    "monarch-money": {      "command": "/abs/path/to/uv",      "args": ["--directory", "/abs/path/to/monarch-mcp", "run", "python", "server.py"],      "env": {        "MONARCH_EMAIL": "[email protected]",        "MONARCH_PASSWORD": "your-password",        "MONARCH_MFA_SECRET": "your-mfa-secret-key"      }    }  }}

[!NOTE] The claude 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

  1. Go to Monarch Money settings and enable 2FA
  2. When shown the QR code, look for "Can't scan?" or "Enter manually"
  3. Copy the TOTP secret key, not the rotating six-digit code
  4. Use this as your MONARCH_MFA_SECRET

Tools

The server exposes these 42 tools.

ToolDescription
get_accountsList accounts with balances
get_transactionsTransactions with date/account/category, pending/posted, and needs-review filtering; returns total_count and next_offset
search_transactionsSearch by merchant name or keyword, with the same filters and paging
get_transaction_categoriesCategory list (compact by default)
get_transaction_rulesPage through compact automation rules in priority order
create_transaction_ruleCreate a rule that matches merchant, statement text, or amount
update_transaction_ruleEdit a rule, and optionally run it on past transactions
delete_transaction_ruleDelete a rule; transactions it already changed stay as they are
get_household_membersHousehold members and IDs for ownership updates
create_transactionCreate a manual transaction
delete_transactionPermanently delete a transaction
update_transactionUpdate transaction fields or assign ownership
update_transactions_bulkUpdate fields or owners with per-item success/failure
get_transaction_splitsRead a transaction's splits
get_transaction_detailsResolve split parent and leg IDs; return split flags, category ID, and resolved transaction ID
update_transaction_splitsReplace all splits; an empty list removes them
get_budgetsBudget data and spending analysis
get_cashflowIncome and expense analysis
get_account_holdingsInvestment holdings for an account (requires account_id)
get_all_holdingsHoldings grouped by brokerage account; excludes other account types
get_account_historyPaginated balance history with inclusive, locally applied ISO date bounds
get_institutionsLinked financial institutions
get_recurring_transactionsScheduled occurrences within a date range
get_recurring_streamsEvery recurring stream with its merchant ID and next forecast
update_recurring_transactionChange a merchant's recurring schedule
get_merchantsPage through merchants with transaction and rule counts
delete_merchantDelete a merchant, optionally moving its transactions to another merchant
get_transaction_tagsList household tags
create_transaction_tagCreate a tag
set_transaction_tagsReplace a transaction's tags; an empty list removes them
set_budget_amountSet a category's monthly budget, optionally for future months too
get_savings_goalsSavings goals with targets, balances, and progress
set_savings_goal_budget_amountSet a goal's planned monthly contribution
create_manual_accountCreate a manually tracked account; valid types are in the accounts://types resource
update_accountRename an account, set its balance, or change net worth and visibility settings
refresh_accountsTrigger account data refresh
get_net_worth_historyDaily net worth, or monthly balances by account type
get_credit_score_historyHousehold credit score snapshots
find_duplicate_transactionsPossible duplicates: same date, amount, statement name, and account
get_spending_summarySpending aggregated by category, account, or month, excluding transfers
get_complete_financial_overviewCompact account, transaction, budget, and cashflow summaries; full sections opt-in
analyze_spending_patternsMonthly 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:

json
{  "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.pickle to clear the cached session
  • Set MONARCH_FORCE_LOGIN=true in your env config to force a fresh login
  • Make 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:

bash
MONARCH_EMAIL="[email protected]"MONARCH_PASSWORD="your-password"MONARCH_MFA_SECRET="YOUR_TOTP_SECRET_KEY"

Tests

bash
uv run pytest tests/ -v                          # offline; live tests are skippedMONARCH_RUN_INTEGRATION=true uv run --env-file .env pytest tests/test_integration.py -vuv run --env-file .env scripts/health_check.py    # live API connectivity check

Integration 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:

bash
uv run python scripts/ci.py

Releasing

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.

bash
uv run scripts/analyze_logs.py                    # full reportuv run scripts/analyze_logs.py --json             # JSON outputuv run scripts/eval_session.py snapshot           # mark log position# ... use tools in Claude ...uv run scripts/eval_session.py analyze            # analyze new entries

Security

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

來源:README.md,提交 9afaeb8

工具

42

get_accounts

Get Accounts

Retrieve all linked financial accounts.

無需輸入參數。

get_transactions

Get Transactions

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

輸入參數limitoffsettag_idsverboseend_dateis_splithas_notesaccount_idis_pendingstart_datecategory_idis_recurring另有 3 個

search_transactions

Search Transactions

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.

輸入參數limitquery必填offsettag_idsverboseend_dateis_splithas_notesaccount_idis_pendingstart_datecategory_id另有 4 個

get_budgets

Get Budgets

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.

輸入參數end_datestart_date

get_cashflow

Get Cashflow

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.

輸入參數end_datestart_date

get_transaction_categories

Get Transaction Categories

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.

輸入參數verbose

create_transaction

Create Transaction

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.

輸入參數date必填notesamount必填account_id必填category_id必填merchant_name必填update_balance

update_transaction

Update Transaction

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.

輸入參數datenotesamountgoal_idcategory_idneeds_reviewmerchant_nameowner_user_idtransaction_id必填hide_from_reports

update_transactions_bulk

Bulk Update Transactions

Update up to 100 transactions, returning per-item results and counts. Args: updates: Array of update objects, or the same array encoded as a JSON 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, five at a time. 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}]

輸入參數updates必填

get_transaction_splits

Get Transaction Splits

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.

輸入參數transaction_id必填

get_transaction_details

Get Transaction Details

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.

輸入參數transaction_id必填

update_transaction_splits

Update Transaction Splits

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.

輸入參數splits必填transaction_id必填

get_all_holdings

Get All Brokerage Holdings

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.

無需輸入參數。

get_transaction_rules

Get Transaction Rules

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.

輸入參數limitoffsetverbose

create_transaction_rule

Create Transaction Rule

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.

輸入參數account_idsadd_tag_idscategory_idsreview_statusamount_criteriaset_category_idhide_from_reportsmerchant_criteriaset_merchant_nameoriginal_statement_criteriaapply_to_existing_transactions

update_transaction_rule

Update Transaction Rule

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.

輸入參數rule_id必填account_idsadd_tag_idscategory_idsreview_statusamount_criteriaset_category_idhide_from_reportsmerchant_criteriaset_merchant_nameclear_amount_criteriaoriginal_statement_criteria另有 1 個

delete_transaction_rule

Delete Transaction Rule

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.

輸入參數rule_id必填

get_household_members

Get Household Members

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.

無需輸入參數。

get_account_holdings

Get Account Holdings

Get investment holdings for an account_id from get_accounts.

輸入參數account_id必填

get_account_history

Get Account History

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.

輸入參數limitoffsetend_dateaccount_id必填start_date

get_institutions

Get Institutions

Get linked financial institutions.

無需輸入參數。

get_recurring_transactions

Get Recurring Transactions

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.

輸入參數end_datestart_date

update_recurring_transaction

Update Recurring Transaction

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.

輸入參數amountbase_datefrequencyis_activemerchant_id必填is_recurringmerchant_name必填

set_budget_amount

Set Budget Amount

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.

輸入參數monthamount必填category_id必填apply_to_future

create_manual_account

Create Manual Account

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.

輸入參數balance必填account_name必填account_type必填account_sub_type必填include_in_net_worth

get_spending_summary

Get Spending Summary

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.

輸入參數end_dategroup_bystart_date

refresh_accounts

Refresh Accounts

Request an institution refresh for all accounts; do not wait for completion.

無需輸入參數。

get_complete_financial_overview

Complete Financial Overview

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.

輸入參數periodverbose

analyze_spending_patterns

Analyze Spending Patterns

Summarize monthly trends, category expenses, account usage, and budget data. Args: lookback_months: Months before today to include, at least 1 (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.

輸入參數verboselookback_monthsinclude_forecasting

get_recurring_streams

Get Recurring Streams

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.

輸入參數verboseactive_onlyinclude_liabilities

get_merchants

Get Merchants

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.

輸入參數limitoffsetverbose

get_transaction_tags

Get Transaction Tags

List household transaction tags: id, name, color, transaction_count. Tag IDs feed set_transaction_tags and the tag_ids filter of get_transactions.

無需輸入參數。

get_net_worth_history

Get Net Worth History

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

輸入參數end_datestart_dateby_account_type

find_duplicate_transactions

Find Duplicate Transactions

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.

輸入參數end_dateaccount_idstart_date

get_savings_goals

Get Savings Goals

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.

輸入參數verboseinclude_archived

get_credit_score_history

Get Credit Score History

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.

無需輸入參數。

set_transaction_tags

Set Transaction Tags

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.

輸入參數tag_ids必填transaction_id必填

create_transaction_tag

Create Transaction Tag

Create a household transaction tag and return it with its new ID. Args: name: Tag name. color: Hex color as #RRGGBB.

輸入參數name必填color

update_account

Update Account

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.

輸入參數namebalanceaccount_id必填include_in_net_worthhide_from_summary_listhide_transactions_from_reports

delete_transaction

Delete Transaction

Permanently delete a transaction by ID from get_transactions or find_duplicate_transactions.

輸入參數transaction_id必填

delete_merchant

Delete Merchant

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.

輸入參數merchant_id必填move_to_merchant_id

set_savings_goal_budget_amount

Set Savings Goal Budget Amount

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.

輸入參數monthamount必填goal_id必填apply_to_future

版本歷史

6
  1. v0.7.1最新Nov 7, 2026
  2. v0.6.0Nov 3, 2026
  3. v0.5.2Sep 29, 2026
  4. v0.5.1Sep 27, 2026
  5. v0.5.0Sep 21, 2026
  6. v0.4.0Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分