b3nw d704f5b82b
All checks were successful
Build and Push Monarch MCP Docker Image / build (push) Successful in 11s
docs: add internal deployment guide, remove temp debug files
- Delete BUG-REPORT.md (bug resolved)
- Delete MonarchAPI.md (research complete, library chosen)
- Add .deployment.md with Komodo stack ops, auth notes, and troubleshooting
2026-05-05 03:27:20 +00:00
2026-05-05 02:59:31 +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%