monarch-money-mcp

mjstramel/monarch-money-mcp

3.3

If you are the rightful owner of monarch-money-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Monarch Money MCP Server allows interaction with Monarch Money data through MCP-compatible clients.

Monarch Money MCP Server

This project provides a Model Context Protocol (MCP) server for Monarch Money, allowing you to interact with your Monarch Money data using MCP-compatible clients (like Windsurf).

Features

  • Exposes Monarch Money API endpoints as MCP tools
  • Tools for accounts, budgets, and transactions
  • Input validation with Zod
  • Logging to dist/mcp-startup.log

Requirements

  • Node.js 18+
  • A Monarch Money API token (see here)

Setup

  1. Clone the repository:
    git clone git@github.com:mjstramel/monarch-money-mcp.git
    cd monarch-money-mcp
    
  2. Install dependencies:
    npm install
    
  3. Set your Monarch Money token:
    export MONARCH_TOKEN=your_token_here
    
  4. Build and run:
    npm run build
    npm start
    

Project Structure

  • src/index.ts — Main MCP server entry point
  • src/operations/monarch.ts — Monarch Money API wrappers and Zod schemas

Add to cursor

{
  "mcpServers": {
    "monarch-money": {
      "command": "node",
      "args": ["<path-to-mcp-server>/dist/index.js"],
      "env": {
        "MONARCH_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Adding More Tools

To add more Monarch Money API endpoints, expand src/operations/monarch.ts and register new tools in src/index.ts.

License

Proprietary / Private