Ben 1d2bf199e1
Some checks failed
Build and Push Monarch MCP Docker Image / build (push) Failing after 10s
fix: update Dockerfile to use pyproject.toml for dependencies
Change from requirements.txt to pyproject.toml as source of truth for
dependencies. This ensures pyotp is properly installed in the Docker image
when built. Using 'uv pip install -e .' will install the package
with all dependencies from pyproject.toml.
2025-12-24 21:41:04 +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%