Monarch Money MCP Server

A Model Context Protocol (MCP) server that provides read-only access to Monarch Money financial data. This allows AI assistants like Claude Desktop to analyze your financial information, transactions, budgets, and cashflow data.

Note: I’ve created this for personal fun and is not affiated with Monarch Money. I mostly created it for learning about my spending, using it for projections. Since I don’t have any need to mutate any data it’s currently READONLY.

Shout out to

Features

• Read-only access to Monarch Money accounts
• Transaction analysis with date filtering and search
• Budget tracking and cashflow analysis
• Account details including investment holdings
• Secure authentication with MFA support
• Session persistence to minimize re-authentication

Installation

Prerequisites

• Python 3.13+
• uv package manager (recommended)
• A Monarch Money account

Setup

1. Clone the repository:

2. Install dependencies:

   uv add mcp monarchmoney python-dotenv
   

3. Configure environment variables:

   cp .env.example .env
   

   Edit .env with your Monarch Money credentials:

   [email protected]
   MONARCH_PASSWORD=your-monarch-password
   MONARCH_MFA_SECRET=your-mfa-secret-key  # Optional but recommended
   

4. Test the connection:

   python test_api.py
   

Usage

Running the Server

Start the MCP server:

python run_server.py

Claude Desktop Integration

Add to your Claude Desktop configuration (claude_desktop_config.json):

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

Available Resources

• monarch://accounts - All linked accounts
• monarch://transactions/recent - Last 100 transactions
• monarch://budgets - Budget information with actual vs target
• monarch://cashflow/summary - Income, expenses, and savings summary

Available Tools

• get_transactions - Get transactions with date range filtering
• get_account_details - Detailed account information including holdings
• get_cashflow_analysis - Cashflow analysis by category and time period
• search_transactions - Search transactions by description or merchant
• get_categories - All transaction categories
• get_institutions - Linked financial institutions

Example Prompts

Once configured with Claude Desktop, you can ask:

• “Show me my recent transactions from last month”
• “What’s my current budget status?”
• “Analyze my spending patterns by category”
• “How much did I spend on groceries this year?”
• “What are my investment account balances?”

Security