Monarch Money MCP Server

Archived in favor of the now officially supported Monarch Money Connector

An MCP (Model Context Protocol) server that provides access to Monarch Money financial data and operations.

Features

• Account Management: List and retrieve account information
• Transaction Operations: Get transactions with filtering by date range, accounts, and categories
• Budget Analysis: Access budget data and spending insights
• Category Management: List and manage transaction categories
• Goal Tracking: Access financial goals and progress
• Net Worth Tracking: Retrieve net worth snapshots over time

Installation

1. Clone or download this MCP server
2. Install dependencies:

   cd /path/to/monarch-money-mcp
   uv sync
   

Configuration

Add the server to your .mcp.json configuration file:

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

Important Notes:

• Replace /path/to/uv with the full path to your uv executable (find it with which uv)
• Replace /path/to/monarch-money-mcp with the absolute path to this server directory
• Use absolute paths, not relative paths

Getting Your MFA Secret

1. Go to Monarch Money settings and enable 2FA
2. When shown the QR code, look for the “Can’t scan?” or “Enter manually” option
3. Copy the secret key (it will be a string like T5SPVJIBRNPNNINFSH5W7RFVF2XYADYX)
4. Use this as your MONARCH_MFA_SECRET

Available Tools

get_accounts

List all accounts with their balances and details.

get_transactions

Get transactions with optional filtering:

• start_date: Filter transactions from this date (YYYY-MM-DD)
• end_date: Filter transactions to this date (YYYY-MM-DD)
• account_ids: List of account IDs to filter by
• category_ids: List of category IDs to filter by
• limit: Maximum number of transactions to return

get_categories

List all transaction categories.

get_budgets

Get budget information and spending analysis.

get_goals

List financial goals and their progress.

get_cashflow

Get cashflow data for income and expense analysis.

get_investments

Get investment account details and performance.

get_net_worth

Get net worth snapshots over time.

Usage Examples

Basic Account Information

Use the get_accounts tool to see all my accounts and their current balances.

Transaction Analysis

Get all transactions from January 2024 using get_transactions with start_date "2024-01-01" and end_date "2024-01-31".

Budget Tracking