monarch-mcp-ultimate
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-mcp-ultimate show me my spending last month"
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-mcp-ultimate
The most capable Monarch Money MCP server — merging the best features from all known implementations into one clean TypeScript project.
Features
Cookie-based auth for Apple Sign In / passkey / Google users (no email+password needed)
Standard email+password auth as a fallback
47 tools covering reads, writes, rules CRUD, merchant management, and intelligence analysis
Natural language dates — "last month", "30 days ago", "this year", etc.
Compact token-efficient transaction format by default (verbose mode available)
Full transaction rules CRUD — get, create, update, delete with exact GraphQL from Monarch's web app
Intelligence tools — rule candidates, uncategorized summary, categorization suggestions from history
Related MCP server: Monarch Money MCP Server
Authentication
Option A — Cookie Auth (for Apple Sign In / passkey / Google users)
This is the only option if you log in with Apple or Google or a passkey.
Open app.monarch.com in Chrome/Safari
Open DevTools → Application tab → Cookies →
app.monarch.comCopy the value of
session_idCopy the value of
csrftoken
{
"env": {
"MONARCH_SESSION_ID": "your-session-id-here",
"MONARCH_CSRF_TOKEN": "your-csrftoken-here"
}
}Sessions expire — you'll need to update these when Monarch logs you out (typically every 30 days or on password change).
Option B — Token Auth (email+password users)
Run the login helper to get a token:
cd /Users/kevinreed/Dev/monarch-mcp-ultimate
node -e "
const { login } = require('./dist/auth');
login('your@email.com', 'yourpassword').then(r => console.log('Token:', r.token));
"Then set MONARCH_TOKEN in your Claude Desktop config.
Claude Desktop Config
Cookie auth (~/.config/claude/claude_desktop_config.json)
{
"mcpServers": {
"monarch": {
"command": "node",
"args": ["/Users/kevinreed/Dev/monarch-mcp-ultimate/dist/index.js"],
"env": {
"MONARCH_SESSION_ID": "abc123...",
"MONARCH_CSRF_TOKEN": "xyz789..."
}
}
}
}Token auth
{
"mcpServers": {
"monarch": {
"command": "node",
"args": ["/Users/kevinreed/Dev/monarch-mcp-ultimate/dist/index.js"],
"env": {
"MONARCH_TOKEN": "your-token-here"
}
}
}
}All 47 Tools
Read Tools (21)
Tool | Description |
| All accounts; verbosity: compact/full |
| Balance for a specific account |
| Paginated transactions with natural language dates |
| Transactions flagged for review |
| Keyword/merchant search |
| Spending totals per category |
| Multi-axis: by category, group, merchant + totals |
| 5 parallel API calls — one-shot snapshot |
| Planned vs actual by category |
| Income + expenses + savings for a date range |
| Total assets minus liabilities |
| Income/expenses/savings for a month |
| All categories and groups |
| Historical balance snapshots |
| Investment holdings and performance |
| All transaction tags |
| Subscriptions, bills, recurring income |
| All auto-categorization rules |
| Savings goals |
| Connected institutions and credential status |
| Merchant details and recurring stream config |
Transaction Write Tools (7)
Tool | Description |
| Category, merchant, amount, date, notes, flags |
| Mark one or many as reviewed |
| Create a new manual transaction |
| Delete by ID |
| Set tags (replaces existing) |
| Split into multiple parts |
| Parallel updates with dry_run support |
Category / Tag Write Tools (3)
Tool | Description |
| New category in a group |
| Delete, optionally moving transactions |
| New transaction tag |
Account Write Tools (4)
Tool | Description |
| Rename, toggle net worth, hide |
| Delete account |
| Create manual account |
| Trigger data refresh |
Budget Tools (1)
Tool | Description |
| Set monthly budget for category or group |
Rules + Merchant Tools (4)
Tool | Description |
| Merchant pattern → category + optional tag/hide actions |
| Update existing rule |
| Delete rule by ID |
| Rename merchant or configure recurring stream |
Intelligence Tools (3)
Tool | Description |
| Suggests rules for merchants with consistent category history |
| Counts uncategorized + needs-review by month |
| Suggests categories for uncategorized transactions based on history |
Natural Language Dates
All date fields accept plain English:
Input | Resolves to |
| Today's date |
| Yesterday |
| First of current month |
| First of previous month |
| Jan 1 of current year |
| Jan 1 of previous year |
| 30 days before today |
| 6 months before today |
| 1 year before today |
| Passed through as-is |
Example Prompts
"Show me everything I spent on restaurants last month"
→ get_transactions(start_date="last month", end_date="today", category_id=...)
"What's my financial overview?"
→ get_complete_financial_overview()
"How much have I spent in the last 90 days, broken down by category?"
→ get_spending_summary(start_date="90 days ago", end_date="today")
"Find rules I should be creating based on my spending patterns"
→ get_rule_candidates(lookback_days=90, min_confidence=0.8)
"Which uncategorized transactions from last month can be auto-categorized?"
→ get_categorization_suggestions(lookback_days=30)
"Create a rule: anything from Amazon goes to Shopping"
→ create_transaction_rule(merchant_criteria_value="Amazon", merchant_criteria_operator="contains", set_category_id="...")
"Rename the merchant 'AMZN MKTP US' to 'Amazon'"
→ update_merchant(merchant_id="...", name="Amazon")
"Mark all transactions needing review as reviewed"
→ get_transactions_needing_review() → mark_transaction_reviewed(transaction_ids=[...])
"What's my uncategorized backlog for the past 6 months?"
→ get_uncategorized_summary(lookback_months=6)Build
cd /Users/kevinreed/Dev/monarch-mcp-ultimate
npm install
npm run buildSources
Built by merging:
keithah/monarch-mcp — TypeScript base, Smithery support
jamiew/monarch-mcp — Natural language dates, compact format, tool annotations, auth retry
robcerda/monarch-mcp-server — Full rules CRUD GraphQL, merchant management, split transactions
randallt21/monarch — Intelligence engine: rule candidates, auto-categorization logic
Available Tools
43 toolsbulk_update_transactionsA
Update multiple transactions in parallel. Supports dry_run to preview changes.
Inputs: updates (required), dry_run.
create_categoryB
Create a new budget category within a category group.
Inputs: name (required), group_id (required), icon, rollover_enabled.
create_manual_accountA
Create a new manual (non-linked) account.
Inputs: name (required), type (required), balance (required), subtype (required), +1 more.
create_tagB
Create a new transaction tag.
Inputs: name (required), color.
create_transactionB
Create a new manual transaction.
Inputs: date (required), amount (required), account_id (required), category_id (required), +3 more.
create_transaction_ruleA
Create a transaction auto-categorization rule. Merchant pattern → category, with optional tag, hide, and review actions.
Inputs: account_ids, add_tag_ids, amount_value, review_status, +9 more.
delete_accountB
Delete an account by ID.
Inputs: account_id (required).
delete_categoryA
Delete a category. Optionally move its transactions to another category.
Inputs: category_id (required), move_to_category_id.
delete_transactionC
Delete a transaction by ID.
Inputs: transaction_id (required).
delete_transaction_ruleA
Delete a transaction rule by ID.
Inputs: rule_id (required).
get_account_balanceB
Get current balance for a specific account by ID.
Inputs: account_id (required).
get_accountsA
Get all accounts. verbosity: "compact" returns id/name/balance/type; "full" returns all fields.
Inputs: verbosity.
get_account_snapshotsA
Get historical account balance snapshots for a date range.
Inputs: end_date (required), start_date (required).
get_budget_summaryA
Get budget planned vs actual amounts by category.
Inputs: end_date, start_date.
get_cashflowA
Get income and expense cashflow summary for a date range.
Inputs: end_date (required), start_date (required).
get_categoriesA
Get all categories and category groups.
Inputs: no named parameters.
get_categorization_suggestionsB
Analyze uncategorized and needs-review transactions and suggest categories based on transaction history for the same merchant. Returns transaction ID, merchant, suggested category, confidence, and history count.
Inputs: min_history, history_days, lookback_days, min_confidence.
get_complete_financial_overviewA
Comprehensive financial overview: accounts, net worth, cashflow, budgets, and recurring transactions in one call.
Inputs: no named parameters.
get_goalsB
Get savings goals.
Inputs: no named parameters.
get_institutionsA
Get connected financial institutions and credential status.
Inputs: no named parameters.
get_merchantB
Get details for a specific merchant including recurring stream configuration.
Inputs: merchant_id (required).
get_monthly_summaryB
Get income, expenses, and savings for a specific month.
Inputs: month.
get_net_worthA
Get current net worth: total assets minus liabilities.
Inputs: no named parameters.
get_portfolioC
Get investment portfolio holdings and performance.
Inputs: end_date, start_date.
get_recurring_transactionsA
Get recurring transaction streams (subscriptions, bills, income).
Inputs: no named parameters.
get_rule_candidatesA
Analyze recent transactions and suggest new rules for merchants with a consistent category pattern. Returns merchant pattern, suggested category, confidence score, and transaction count. High-value input for create_transaction_rule.
Inputs: lookback_days, min_confidence, min_transactions, exclude_existing_rules.
get_spending_by_categoryA
Get spending broken down by category for a date range.
Inputs: end_date (required), start_date (required).
get_spending_summaryC
Multi-axis spending analysis: by category, category group, and merchant, with overall income/expense/savings.
Inputs: end_date, start_date.
get_tagsA
Get all transaction tags.
Inputs: no named parameters.
get_transaction_rulesA
Get all transaction auto-categorization rules with criteria and actions.
Inputs: no named parameters.
get_transactionsB
Get transactions. Supports natural language dates (today, last month, 30 days ago, etc.). Returns compact format by default.
Inputs: limit, offset, tag_ids, verbose, +4 more.
get_transactions_needing_reviewC
Get all transactions that need review. Returns compact format by default.
Inputs: limit, verbose, end_date, start_date.
get_uncategorized_summaryA
Count uncategorized and needs-review transactions by month. Useful for understanding categorization backlog.
Inputs: lookback_months.
mark_transaction_reviewedB
Mark one or more transactions as reviewed (needsReview = false).
Inputs: transaction_id, transaction_ids.
refresh_accountsA
Request a data refresh for linked accounts. Optionally pass specific account IDs; defaults to all active linked accounts.
Inputs: account_ids.
search_transactionsB
Search transactions by keyword/merchant name with optional date range.
Inputs: query (required), limit, verbose, end_date, +1 more.
set_budget_amountB
Set the monthly budget amount for a category or category group.
Inputs: amount (required), start_date, category_id, apply_to_future, +1 more.
set_transaction_tagsA
Set tags on a transaction. REPLACES all existing tags. Pass empty array to clear.
Inputs: tag_ids (required), transaction_id (required).
split_transactionA
Split a transaction into multiple parts. Sum of split amounts must equal original. Pass empty splits array to remove splits.
Inputs: splits (required), transaction_id (required).
update_accountB
Rename an account, toggle net worth inclusion, or hide it.
Inputs: account_id (required), name, hide_from_list, display_balance, +2 more.
update_merchantA
Rename a merchant globally or update its recurring stream settings (frequency, amount, base date).
Inputs: merchant_id (required), name, amount, base_date, +3 more.
update_transactionC
Update a transaction: category, merchant, amount, date, notes, hideFromReports, needsReview.
Inputs: transaction_id (required), date, notes, amount, +5 more.
update_transaction_ruleC
Update an existing transaction rule by ID.
Inputs: rule_id (required), account_ids, add_tag_ids, amount_value, +10 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 43 tools
Most tools have clear distinct purposes, but the large set of reporting tools (get_spending_summary, get_cashflow, get_monthly_summary, get_complete_financial_overview) may cause confusion. Descriptions do help differentiate, but the overlap is noticeable.
All tool names follow a consistent snake_case verb_noun pattern (e.g., get_accounts, create_transaction, delete_transaction_rule). No mixed conventions or inconsistent verb usage.
With 43 tools, the server is over-configured. While the expansive domain of personal finance justifies many operations, the count exceeds the typical well-scoped range and will increase selection complexity for agents.
Core CRUD for transactions, accounts, and rules is well covered. However, gaps exist for tag deletion, category updates, and full goal management (only get_goals is provided).
Maintenance
Related MCP Connectors
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.
Personal finance for AI agents — onboard, import statements, categorize & budget over MCP.
Hosted remote MCP server for YNAB on Cloudflare Workers with OAuth
Query your real net worth, spending, transactions, budgets and portfolio from any MCP client.
Related MCP Servers
- AlicenseBqualityAmaintenanceMCP Server for Monarch Money, utilizing an unofficial api.11434MIT
- 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
- AlicenseCqualityCmaintenanceUnofficial MCP server for Monarch Money that exposes tools for managing accounts, transactions, budgets, and other financial data through natural language.1251MIT