Ben 4382b02450
Some checks failed
Build and Push Monarch MCP Docker Image / build (push) Failing after 8s
fix: use monarchmoney from git main to get budget fix (#119)
Since no release has been published in ~11 months, install monarchmoney
directly from git main branch which contains the fix for flexible budgets.
Also updates gql to >=4.0 as required by the main branch.
2025-12-25 04:35:06 +00:00

Monarch Money Custom MCP Server

A custom Model Context Protocol (MCP) server for Monarch Money, designed for Docker deployment with SSE (Server-Sent Events) support.

🚀 Setup

1. Obtain Authentication Token

Run the setup script locally to authenticate and generate a token:

python login_setup.py

Follow the prompts to log in. Once successful, copy the MONARCH_TOKEN printed in the terminal.

2. Configure Environment

Create a .env file based on .env.example and paste your token:

cp .env.example .env
# Edit .env and set MONARCH_TOKEN=your_token_here

3. Deploy with Docker

Start the server using Docker Compose:

docker-compose up -d

🔌 Connection

The server will be available at:

  • MCP Endpoint: http://localhost:8000/mcp
  • Health Check: http://localhost:8000/health

🛠️ Tools Included

  • get_accounts: View all financial accounts.
  • get_transactions: Fetch recent transactions with filtering.
  • get_budgets: View budget status.
  • get_account_holdings: Detailed investment holdings.
  • refresh_accounts: Trigger a refresh of account data.
Description
No description provided
Readme 1 MiB
Languages
Python 94.8%
Dockerfile 5.2%