Imported from reason-machines/mcp-skills (skills/monarch-money-mcp-server/SKILL.md). Install upstream with npx skills add reason-machines/mcp-skills --skill monarch-money-mcp-server. Copyright stays with the author.

Monarch Money MCP Server

Skill by ara.so — MCP Skills collection

Overview

The Monarch Money MCP Server provides seamless integration with the Monarch Money personal finance platform through the Model Context Protocol. It enables Claude Desktop and Claude Code to access your financial accounts, transactions, budgets, analytics, and more through a comprehensive set of tools.

Built on the MonarchMoneyCommunity Python library with full MFA support.

Installation

1. Clone and Install Dependencies

git clone https://github.com/robcerda/monarch-mcp-server.git
cd monarch-mcp-server

# Using pip
pip install -r requirements.txt
pip install -e .

# OR using uv
uv sync

2. Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "Monarch Money": {
      "command": "/opt/homebrew/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with-editable",
        "/absolute/path/to/monarch-mcp-server",
        "mcp",
        "run",
        "/absolute/path/to/monarch-mcp-server/src/monarch_mcp_server/server.py"
      ]
    }
  }
}

If using pip instead of uv:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "python",
      "args": ["/absolute/path/to/monarch-mcp-server/src/monarch_mcp_server/server.py"]
    }
  }
}

3. Configure Claude Code (CLI)

Global config (~/.claude.json or %USERPROFILE%\.claude.json):

{
  "mcpServers": {
    "Monarch Money": {
      "command": "/opt/homebrew/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with-editable",
        "/absolute/path/to/monarch-mcp-server",
        "mcp",
        "run",
        "/absolute/path/to/monarch-mcp-server/src/monarch_mcp_server/server.py"
      ]
    }
  }
}

Project-level config (.mcp.json in project directory):

{
  "Monarch Money": {
    "command": "/opt/homebrew/bin/uv",
    "args": [
      "run",
      "--with",
      "mcp[cli]",
      "--with-editable",
      "/absolute/path/to/monarch-mcp-server",
      "mcp",
      "run",
      "/absolute/path/to/monarch-mcp-server/src/monarch_mcp_server/server.py"
    ]
  }
}

4. One-Time Authentication

Run the authentication setup script outside of Claude:

cd /absolute/path/to/monarch-mcp-server

# Using python
python login_setup.py

# OR using uv
uv run python login_setup.py

Follow prompts to enter:

Monarch Money email and password
2FA code (if MFA is enabled)

Session tokens are stored securely and persist for weeks/months.

For SSO/Google sign-in users: Use the monarch_login_with_token function to paste a session token from your browser.

Core Tools

Account Management

`get_accounts`

Retrieve all linked financial accounts with balances and institution info.

# Returns all accounts with: id, displayName, currentBalance, accountType, institution
get_accounts()

Example prompt:

Show me all my financial accounts

`get_account_holdings`

View securities and investments in investment accounts.

get_account_holdings(account_id="acc_123456")

Example prompt:

What holdings do I have in my investment account acc_123456?

`refresh_accounts`

Request real-time data refresh from financial institutions.

refresh_accounts()

Example prompt:

Refresh all my account balances from the banks

Transaction Access

`get_transactions`

Fetch transactions with filtering, pagination, and reconciliation fields.

# Basic usage - last 50 transactions
get_transactions(limit=50)

# Filtered by date range
get_transactions(
    start_date="2024-01-01",
    end_date="2024-01-31",
    limit=100
)

# Filter by account and category
get_transactions(
    account_id="acc_123",
    category_ids=["cat_456", "cat_789"],
    limit=50,
    offset=0
)

# Search transactions
get_transactions(
    search="Amazon",
    wide_search=True,
    limit=25
)

# Filter by flags
get_transactions(
    has_notes=False,
    is_split=False,
    limit=100
)

Example prompts:

Show me my last 100 transactions
Get all Amazon transactions from January 2024
Show me uncategorized transactions with no notes

`create_transaction`

Add a new transaction to an account.

create_transaction(
    account_id="acc_123",
    amount=-45.99,
    description="Coffee shop",
    date="2024-01-15",
    category_id="cat_dining",
    merchant_name="Local Cafe"
)

Example prompt:

Create a transaction for $45.99 at Local Cafe on January 15th in my checking account

`update_transaction`

Modify existing transaction details.

update_transaction(
    transaction_id="txn_789",
    amount=-52.00,
    description="Grocery store shopping",
    category_id="cat_groceries",
    date="2024-01-16"
)

Example prompt:

Update transaction txn_789 to $52 and change the category to groceries

Budget Management

`get_budgets`

Access budget information with spending analysis.

# Current month budgets
get_budgets()

# Specific date range
get_budgets(
    start_date="2024-01-01",
    end_date="2024-12-31"
)

Example prompt:

Show me my budgets for 2024

`set_budget_amount`

Create or modify budget amounts.

# Set budget for a category
set_budget_amount(
    amount=500.00,
    category_id="cat_dining",
    start_date="2024-02-01",
    apply_to_future=True
)

# Set budget for a category group
set_budget_amount(
    amount=2000.00,
    category_group_id="grp_housing",
    start_date="2024-02-01",
    apply_to_future=False
)

Example prompt:

Set my dining budget to $500 per month starting in February

Category Management

`get_categories`

List all transaction categories with groups and metadata.

get_categories()
# Returns: id, name, group, icon, systemCategory, isSystemCategory, isDisabled

Example prompt:

List all my transaction categories

`get_category_groups`

View category groups with their associated categories.

get_category_groups()

Example prompt:

Show me all category groups

`set_transaction_category`

Assign a category to a transaction.

set_transaction_category(
    transaction_id="txn_123",
    category_id="cat_groceries",
    mark_reviewed=True
)

Example prompt:

Categorize transaction txn_123 as groceries and mark it reviewed

`bulk_categorize_transactions`

Apply a category to multiple transactions at once.

bulk_categorize_transactions(
    transaction_ids=["txn_1", "txn_2", "txn_3"],
    category_id="cat_dining"
)

Example prompt:

Categorize all these Amazon transactions as shopping: txn_1, txn_2, txn_3

Transaction Review Workflow

`get_transactions_needing_review`

Find transactions requiring attention.

# All transactions needing review
get_transactions_needing_review(needs_review=True)

# Uncategorized transactions only
get_transactions_needing_review(uncategorized=True)

# Transactions without notes
get_transactions_needing_review(no_notes=True)

# Last N days
get_transactions_needing_review(
    needs_review=True,
    days=30
)

Example prompt:

Show me all uncategorized transactions from the last 30 days

`update_transaction_notes`

Add or update notes on transactions.

update_transaction_notes(
    transaction_id="txn_456",
    notes="Receipt: https://example.com/receipt.pdf"
)

Example prompt:

Add a note to transaction txn_456 with the receipt link

`mark_transaction_reviewed`

Clear the needs_review flag.

mark_transaction_reviewed(transaction_id="txn_789")

Example prompt:

Mark transaction txn_789 as reviewed

Tag Management

`get_tags`

List all available tags with colors and usage counts.

get_tags()

Example prompt:

Show me all my transaction tags

`set_transaction_tags`

Apply tags to a transaction.

set_transaction_tags(
    transaction_id="txn_123",
    tag_ids=["tag_business", "tag_reimbursable"]
)

Example prompt:

Tag transaction txn_123 as business and reimbursable

`create_tag`

Create a new tag with custom name and color.

create_tag(
    name="Travel",
    color="#FF5733"
)

Example prompt:

Create a new tag called Travel with color red

Advanced Search

`search_transactions`

Comprehensive search with multiple filters.

search_transactions(
    search="Starbucks",
    category_ids=["cat_dining"],
    account_ids=["acc_checking"],
    tag_ids=["tag_business"],
    start_date="2024-01-01",
    end_date="2024-01-31",
    min_amount=5.00,
    max_amount=50.00
)

Example prompt:

Find all Starbucks transactions tagged as business between $5 and $50 in January

`get_transaction_details`

Retrieve complete details for a single transaction.

get_transaction_details(transaction_id="txn_456")

Example prompt:

Get full details for transaction txn_456

`delete_transaction`

Remove a transaction.

delete_transaction(transaction_id="txn_789")

Example prompt:

Delete transaction txn_789

`get_recurring_transactions`

View upcoming recurring transactions.

get_recurring_transactions()

Example prompt:

Show me all my recurring transactions

Transaction Rules (Auto-Categorization)

`get_transaction_rules`

List all auto-categorization rules.

get_transaction_rules()

Example prompt:

Show me all my transaction rules

`create_transaction_rule`

Create rules with merchant/amount conditions.

create_transaction_rule(
    merchant_criteria_operator="contains",
    merchant_criteria_value="Spotify",
    set_category_id="cat_subscriptions",
    add_tag_ids=["tag_recurring"]
)

# Rule with amount criteria
create_transaction_rule(
    merchant_criteria_operator="contains",
    merchant_criteria_value="Gas",
    set_category_id="cat_transportation",
    amount_operator="greater_than",
    amount_value=20.00
)

Example prompt:

Create a rule to categorize all Spotify transactions as subscriptions

`update_transaction_rule`

Modify existing rules.

update_transaction_rule(
    rule_id="rule_123",
    merchant_criteria_operator="equals",
    merchant_criteria_value="Netflix",
    set_category_id="cat_entertainment"
)

Example prompt:

Update rule rule_123 to use exact match for Netflix

`delete_transaction_rule`

Remove a rule.

delete_transaction_rule(rule_id="rule_456")

Example prompt:

Delete transaction rule rule_456

Transaction Splits

`get_transaction_splits`

View how a transaction has been split.

get_transaction_splits(transaction_id="txn_789")

Example prompt:

Show me the splits for transaction txn_789

`split_transaction`

Divide a transaction into multiple parts.

split_transaction(
    transaction_id="txn_123",
    splits=[
        {
            "amount": -30.00,
            "category_id": "cat_groceries",
            "merchant_name": "Target - Groceries"
        },
        {
            "amount": -20.00,
            "category_id": "cat_household",
            "merchant_name": "Target - Household"
        }
    ]
)

Example prompt:

Split transaction txn_123: $30 for groceries and $20 for household items

Financial Analysis

`get_cashflow`

Analyze income and expenses over time.

get_cashflow(
    start_date="2024-01-01",
    end_date="2024-12-31"
)

Example prompt:

Show me my cashflow for 2024

`get_net_worth`

Track net worth with daily snapshots and trends.

# All accounts
get_net_worth(
    start_date="2023-01-01",
    end_date="2024-12-31"
)

# Specific account type
get_net_worth(
    start_date="2024-01-01",
    end_date="2024-12-31",
    account_type="investment"
)

Example prompt:

Show me my net worth trend for 2024

`get_account_balance_history`

View historical balance data for an account.

get_account_balance_history(account_id="acc_checking_123")

Example prompt:

Show me the balance history for my checking account

`get_net_worth_by_account_type`

Net worth breakdown across account types.

get_net_worth_by_account_type(
    start_date="2024-01-01",
    timeframe="monthly"
)

Example prompt:

Break down my net worth by account type for 2024

`get_transactions_summary`

Quick high-level statistics about transactions.

get_transactions_summary()

Example prompt:

Give me a summary of my transactions

`get_spending_summary`

Spending breakdown by category.

get_spending_summary(
    start_date="2024-01-01",
    end_date="2024-01-31",
    limit=10
)

Example prompt:

Show me my top 10 spending categories for January

Common Patterns

Monthly Budget Review

# 1. Get current month budgets
budgets = get_budgets()

# 2. Check spending summary
summary = get_spending_summary(
    start_date="2024-01-01",
    end_date="2024-01-31",
    limit=20
)

# 3. Review over-budget categories
# Identify categories where spent > budgeted

# 4. Adjust next month's budgets
set_budget_amount(
    amount=600.00,
    category_id="cat_groceries",
    start_date="2024-02-01",
    apply_to_future=True
)

Transaction Cleanup Workflow

# 1. Find transactions needing review
needs_review = get_transactions_needing_review(
    uncategorized=True,
    days=30
)

# 2. Categorize similar transactions in bulk
bulk_categorize_transactions(
    transaction_ids=["txn_1", "txn_2", "txn_3"],
    category_id="cat_groceries"
)

# 3. Add notes where needed
update_transaction_notes(
    transaction_id="txn_4",
    notes="Reimbursable expense"
)

# 4. Mark reviewed
mark_transaction_reviewed(transaction_id="txn_4")

Auto-Categorization Setup

# 1. Review common merchants
transactions = search_transactions(
    search="Spotify",
    limit=10
)

# 2. Create rule for automatic categorization
create_transaction_rule(
    merchant_criteria_operator="contains",
    merchant_criteria_value="Spotify",
    set_category_id="cat_subscriptions",
    add_tag_ids=["tag_recurring", "tag_entertainment"]
)

# 3. Verify rule is working
rules = get_transaction_rules()

Investment Portfolio Review

# 1. Get all investment accounts
accounts = get_accounts()
investment_accounts = [a for a in accounts if a['accountType'] == 'investment']

# 2. Check holdings for each
for acc in investment_accounts:
    holdings = get_account_holdings(account_id=acc['id'])
    
# 3. Review balance history
history = get_account_balance_history(account_id=acc['id'])

# 4. Check overall net worth trend
net_worth = get_net_worth(
    start_date="2023-01-01",
    end_date="2024-12-31",
    account_type="investment"
)

Expense Tracking with Tags

# 1. Create project-specific tags
create_tag(name="Project Alpha", color="#3498db")
create_tag(name="Reimbursable", color="#e74c3c")

# 2. Tag relevant transactions
set_transaction_tags(
    transaction_id="txn_123",
    tag_ids=["tag_project_alpha", "tag_reimbursable"]
)

# 3. Search for all project expenses
project_expenses = search_transactions(
    tag_ids=["tag_project_alpha"],
    start_date="2024-01-01",
    end_date="2024-12-31"
)

# 4. Calculate total reimbursable amount
reimbursable = search_transactions(
    tag_ids=["tag_reimbursable"],
    start_date="2024-01-01",
    end_date="2024-01-31"
)

Authentication

Check Authentication Status

check_auth_status()

Example prompt:

Check if I'm authenticated with Monarch Money

Get Setup Instructions

setup_authentication()

Example prompt:

How do I set up authentication for Monarch Money?

Troubleshooting

Authentication Issues

Problem: "Session not found" or authentication errors

Solution:

Run python login_setup.py from the terminal
Enter credentials and 2FA code if prompted
Restart Claude Desktop or Claude Code
Verify session file exists in ~/.monarch/session.pickle

Missing Transactions

Problem: Transactions don't appear or are outdated

Solution:

# Force a refresh from financial institutions
refresh_accounts()

# Wait a few minutes, then check again
get_transactions(limit=50)

Tool Not Found

Problem: MCP server not showing in Claude

Solution:

Verify configuration file path (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json)
Check absolute paths in config - no ~ or relative paths
Restart Claude Desktop completely (quit and reopen)
Check Claude Desktop logs for errors

Performance with Large Result Sets

Problem: Timeouts or slow responses with many transactions

Solution:

# Use pagination for large datasets
get_transactions(limit=100, offset=0)
get_transactions(limit=100, offset=100)

# Filter by date range
get_transactions(
    start_date="2024-01-01",
    end_date="2024-01-31",
    limit=500
)

# Use search with specific criteria
search_transactions(
    search="Amazon",
    start_date="2024-01-01",
    end_date="2024-01-31"
)

Split Transaction Issues

Problem: Split amounts don't sum to original transaction

Solution:

# Ensure split amounts sum exactly to transaction amount
# Original transaction: -$100
split_transaction(
    transaction_id="txn_123",
    splits=[
        {"amount": -60.00, "category_id": "cat_1"},
        {"amount": -40.00, "category_id": "cat_2"}
    ]
)
# Sum: -$100 ✓

Budget Not Updating

Problem: Budget changes not reflected

Solution:

# Ensure apply_to_future is set correctly
set_budget_amount(
    amount=500.00,
    category_id="cat_dining",
    start_date="2024-02-01",
    apply_to_future=True  # Apply to current and future months
)

Environment Variables

The server uses secure session storage. No environment variables are required for normal operation.

Session storage location:

macOS/Linux: ~/.monarch/session.pickle
Windows: %USERPROFILE%\.monarch\session.pickle

About

Monarch Money MCP Server

Overview

Installation

1. Clone and Install Dependencies

2. Configure Claude Desktop

3. Configure Claude Code (CLI)

4. One-Time Authentication

Core Tools

Account Management

get_accounts

get_account_holdings

refresh_accounts

Transaction Access

get_transactions

create_transaction

update_transaction

Budget Management

get_budgets

set_budget_amount

Category Management

get_categories

get_category_groups

set_transaction_category

bulk_categorize_transactions

Transaction Review Workflow

get_transactions_needing_review

update_transaction_notes

mark_transaction_reviewed

Tag Management

get_tags

set_transaction_tags

create_tag

Advanced Search

search_transactions

get_transaction_details

delete_transaction

get_recurring_transactions

Transaction Rules (Auto-Categorization)

get_transaction_rules

create_transaction_rule

update_transaction_rule

delete_transaction_rule

Transaction Splits

get_transaction_splits

split_transaction

Financial Analysis

get_cashflow

get_net_worth

get_account_balance_history

get_net_worth_by_account_type

get_transactions_summary

get_spending_summary

Common Patterns

Monthly Budget Review

Transaction Cleanup Workflow

Auto-Categorization Setup

Investment Portfolio Review

Expense Tracking with Tags

Authentication

Check Authentication Status

Get Setup Instructions

Troubleshooting

Authentication Issues

Missing Transactions

Tool Not Found

Performance with Large Result Sets

Split Transaction Issues

Budget Not Updating

Environment Variables

Additional Resources

Use it

Manifest

Reviews

`get_accounts`

`get_account_holdings`

`refresh_accounts`

`get_transactions`

`create_transaction`

`update_transaction`

`get_budgets`

`set_budget_amount`

`get_categories`

`get_category_groups`

`set_transaction_category`

`bulk_categorize_transactions`

`get_transactions_needing_review`

`update_transaction_notes`

`mark_transaction_reviewed`

`get_tags`

`set_transaction_tags`

`create_tag`

`search_transactions`

`get_transaction_details`

`delete_transaction`

`get_recurring_transactions`

`get_transaction_rules`

`create_transaction_rule`

`update_transaction_rule`

`delete_transaction_rule`

`get_transaction_splits`

`split_transaction`

`get_cashflow`

`get_net_worth`

`get_account_balance_history`

`get_net_worth_by_account_type`

`get_transactions_summary`

`get_spending_summary`