Skip to main content
Glama
monarch-mcp-ultimate

monarch-mcp-ultimate

by oyemecarnal

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

This is the only option if you log in with Apple or Google or a passkey.

  1. Open app.monarch.com in Chrome/Safari

  2. Open DevTools → Application tab → Cookies → app.monarch.com

  3. Copy the value of session_id

  4. Copy 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

{
  "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

get_accounts

All accounts; verbosity: compact/full

get_account_balance

Balance for a specific account

get_transactions

Paginated transactions with natural language dates

get_transactions_needing_review

Transactions flagged for review

search_transactions

Keyword/merchant search

get_spending_by_category

Spending totals per category

get_spending_summary

Multi-axis: by category, group, merchant + totals

get_complete_financial_overview

5 parallel API calls — one-shot snapshot

get_budget_summary

Planned vs actual by category

get_cashflow

Income + expenses + savings for a date range

get_net_worth

Total assets minus liabilities

get_monthly_summary

Income/expenses/savings for a month

get_categories

All categories and groups

get_account_snapshots

Historical balance snapshots

get_portfolio

Investment holdings and performance

get_tags

All transaction tags

get_recurring_transactions

Subscriptions, bills, recurring income

get_transaction_rules

All auto-categorization rules

get_goals

Savings goals

get_institutions

Connected institutions and credential status

get_merchant

Merchant details and recurring stream config

Transaction Write Tools (7)

Tool

Description

update_transaction

Category, merchant, amount, date, notes, flags

mark_transaction_reviewed

Mark one or many as reviewed

create_transaction

Create a new manual transaction

delete_transaction

Delete by ID

set_transaction_tags

Set tags (replaces existing)

split_transaction

Split into multiple parts

bulk_update_transactions

Parallel updates with dry_run support

Category / Tag Write Tools (3)

Tool

Description

create_category

New category in a group

delete_category

Delete, optionally moving transactions

create_tag

New transaction tag

Account Write Tools (4)

Tool

Description

update_account

Rename, toggle net worth, hide

delete_account

Delete account

create_manual_account

Create manual account

refresh_accounts

Trigger data refresh

Budget Tools (1)

Tool

Description

set_budget_amount

Set monthly budget for category or group

Rules + Merchant Tools (4)

Tool

Description

create_transaction_rule

Merchant pattern → category + optional tag/hide actions

update_transaction_rule

Update existing rule

delete_transaction_rule

Delete rule by ID

update_merchant

Rename merchant or configure recurring stream

Intelligence Tools (3)

Tool

Description

get_rule_candidates

Suggests rules for merchants with consistent category history

get_uncategorized_summary

Counts uncategorized + needs-review by month

get_categorization_suggestions

Suggests categories for uncategorized transactions based on history


Natural Language Dates

All date fields accept plain English:

Input

Resolves to

today

Today's date

yesterday

Yesterday

this month

First of current month

last month

First of previous month

this year

Jan 1 of current year

last year

Jan 1 of previous year

30 days ago

30 days before today

6 months ago

6 months before today

1 year ago

1 year before today

2025-03-15

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 build

Sources

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 tools
bulk_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

    B3.3/5.0

    Scored across 43 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An 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.
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      30
      46 npm
      2
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Unofficial MCP server for Monarch Money that exposes tools for managing accounts, transactions, budgets, and other financial data through natural language.
      125
      1
      MIT