Monarch Money

io.github.vargahisPublished by GitHub account vargahisv0.1.4Updated Oct 24, 2026

MCP server for Monarch Money — accounts, transactions, budgets, cashflow, investments, and more

VerifiedSTDIODesktop onlyFinance Data & Analytics

Server details

Identifier: io.github.vargahis/monarch-money
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account vargahis for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.vargahis%2Fmonarch-money.svg)](https://sourceweft.com/mcp/io.github.vargahis%2Fmonarch-money?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Lets an assistant read and, if enabled, modify Monarch Money personal finance data such as accounts, transactions, budgets and cashflow.

What you can do: Connects an assistant to a Monarch Money account through 44 tools covering accounts, transactions and splits, tags, categories, transaction rules, recurring merchants, budgets, cashflow, investments and credit history. It starts in read-only mode, so write tools are hidden and blocked until explicitly enabled. Read tools retrieve and analyze balances, spending, net worth and budget status; write tools can create, update and delete transactions, tags, categories, rules, budgets and accounts.
When to use it: Useful when you want an assistant to answer questions about your own Monarch Money finances, summarize spending or cashflow, or make bulk edits to transactions, tags and rules. Best for personal finance review and analysis rather than general financial advice.
Requirements: Runs locally as a Python package via uvx, pip, or a Claude Desktop extension file; desktop only. Authentication happens in a browser on first start, with email, password and a 2FA code if enabled; the resulting token is stored in the OS keyring. No environment variables or headers are declared.

Before you install

Write tools are off by default and must be enabled explicitly; once on, they can create, update and delete transactions, tags, categories, rules, budgets and accounts. Credentials are entered in the browser, not in config files, and the session token is kept in the OS keyring. Optional live integration tests can use MONARCH_EMAIL and MONARCH_PASSWORD and create and delete real data prefixed with MCP-Test-.

Installation

In SourceWeft

Open Monarch Money in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Monarch Money MCP Server

A Model Context Protocol (MCP) server for integrating with the Monarch Money personal finance platform through Claude Desktop.

Overview

Secure by design — browser-based login, token stored in OS keychain (never in config files or env vars)
Safe by default — read-only mode prevents accidental changes; write tools require explicit opt-in
Comprehensive — 44 tools covering accounts, transactions, splits, budgets, cashflow, tags, categories, transaction rules, recurring merchants, and credit history
Easy to install — Claude Desktop extension (.mcpb), uvx, or pip

Two operating modes:

The server starts in read-only mode by default. Write tools are hidden and blocked until you explicitly opt in.

	Read-only (default)	Write mode
View accounts, transactions, budgets	Yes	Yes
Analyze cashflow, spending, net worth	Yes	Yes
Create transactions, tags, categories, rules	No	Yes
Update accounts, budgets, splits	No	Yes
Delete transactions, tags, accounts	No	Yes

Quick Start

Installation

Option 1: Claude Desktop Extension (.mcpb) — Recommended for Claude Desktop

Enables toggling write mode on/off directly from the Claude Desktop app.

Download the latest .mcpb from Releases
In Claude Desktop: Settings > Extensions > Advanced Settings > Install Extensions — select the .mcpb file
Restart Claude Desktop

To enable write tools: Settings > Extensions > Monarch Money MCP Server > Configure — toggle "Enable write tools" and click Save.

Option 2: uvx (no install required) — Recommended for agents (e.g. Claude Code or Cursor)

Also works with Claude Desktop, but write mode cannot be toggled from the app — set it in the config instead.

Add to your MCP config file:

json

{  "mcpServers": {    "Monarch Money": {      "command": "uvx",      "args": ["monarch-mcp"]    }  }}

{  "mcpServers": {    "Monarch Money": {      "command": "uvx",      "args": ["monarch-mcp"]    }  }}

To enable write tools:

json

{  "mcpServers": {    "Monarch Money": {      "command": "uvx",      "args": ["monarch-mcp", "--enable-write"]    }  }}

{  "mcpServers": {    "Monarch Money": {      "command": "uvx",      "args": ["monarch-mcp", "--enable-write"]    }  }}

Option 3: pip install — Recommended for local installation and venv

Contributors: See docs/releasing.md for the release process, version scheme, and pre-release testing via TestPyPI.

Add to your MCP config using the full path to your Python interpreter:

json

{  "mcpServers": {    "Monarch Money": {      "command": "/path/to/bin/python3",      "args": ["-m", "monarch_mcp"]    }  }}

{  "mcpServers": {    "Monarch Money": {      "command": "/path/to/bin/python3",      "args": ["-m", "monarch_mcp"]    }  }}

To enable write tools, add "--enable-write" to args.

Option 4: Clone and install — Recommended for development

Then add to your MCP config using the Python interpreter from your dev environment:

json

{  "mcpServers": {    "Monarch Money": {      "command": "/path/to/bin/python3",      "args": ["-m", "monarch_mcp"]    }  }}

{  "mcpServers": {    "Monarch Money": {      "command": "/path/to/bin/python3",      "args": ["-m", "monarch_mcp"]    }  }}

To enable write tools, add "--enable-write" to args.

Authentication

Authentication happens automatically in your browser the first time the MCP server starts without a saved session.

Start (or restart) Claude Desktop
The server detects that no token exists and opens a login page in your browser
Enter your Monarch Money email and password
Provide your 2FA code if you have MFA enabled
Once authenticated, the token is saved to your system keyring — you're all set

Key details:

Credentials are entered in your browser only — never through Claude Desktop
Token stored in the OS keyring — persists across restarts, lasts weeks/months
Expired sessions re-authenticate automatically — the browser login re-triggers on the next tool call
MFA fully supported
Fallback: run python login_setup.py in a terminal for headless environments

For technical details on the auth architecture, see docs/authentication.md.

Usage Examples

Available Tools

Tool	Description	Mode
Auth
`setup_authentication`	Get setup instructions	read
`check_auth_status`	Check authentication status	read
`debug_session_loading`	Debug keyring issues	read
Accounts
`get_accounts`	Get all financial accounts	read
`get_account_holdings`	Get investment holdings	read
`get_account_history`	Get historical balance data	read
`get_recent_account_balances`	Get daily balances	read
`get_account_snapshots_by_type`	Net worth by account type	read
`get_aggregate_snapshots`	Daily aggregate net value	read
`get_institutions`	Get connected institutions	read
`get_account_type_options`	Get valid account types	read
`refresh_accounts`	Request account data refresh	read
`create_manual_account`	Create manual account	write
`update_account`	Update account settings	write
`delete_account`	Delete an account	write
Transactions
`get_transactions`	Get transactions with filtering (date, account, category, tag, search, needs_review, and more)	read
`get_transaction_details`	Get full transaction detail	read
`get_transactions_summary`	Aggregate transaction stats	read
`get_transaction_splits`	Get split information	read
`get_recurring_transactions`	Get recurring transactions	read
`find_merchant_id_by_name`	Search recent transactions for a merchant and return distinct IDs	read
`create_transaction`	Create new transaction	write
`update_transaction`	Update existing transaction (clear notes with `clear_notes`, unlink goal with `clear_goal`)	write
`delete_transaction`	Delete a transaction	write
`update_transaction_splits`	Create/modify/delete splits	write
`update_recurring_merchant`	Mark/unmark a merchant as recurring, update its frequency/amount, or deactivate it — `is_recurring` is required on every call (requires `--enable-write`)	write
Tags
`get_transaction_tags`	Get all tags	read
`create_transaction_tag`	Create new tag	write
`delete_transaction_tag`	Delete a tag	write
`set_transaction_tags`	Set tags on a transaction	write
Categories
`get_transaction_categories`	Get all categories	read
`get_transaction_category_groups`	Get category groups	read
`create_transaction_category`	Create a category	write
`delete_transaction_category`	Delete a category	write
Rules
`get_transaction_rules`	List every transaction rule with its criteria, actions, and recent application stats	read
`create_transaction_rule`	Create a transaction rule with full criteria + actions (category, tags, merchant, amount, splits…)	write
`update_transaction_rule`	Update a rule by id; merges overrides onto the current rule (handles Monarch's REPLACE semantics)	write
`delete_transaction_rule`	Delete a rule by ID	write
Budgets & Cashflow
`get_budgets`	Get budget information	read
`get_cashflow`	Get cashflow analysis	read
`get_cashflow_summary`	Get cashflow summary	read
`set_budget_amount`	Set budget for category	write
Other
`get_subscription_details`	Get subscription status	read
`get_credit_history`	Get credit score history	read

Testing

This project has two complementary test surfaces:

1. Mocked unit tests (the quality gate) — fast, offline, no Monarch connection. These run in CI and must stay green:

The Monarch client is mocked, so these never touch a real account. Live e2e tests (below) are deselected by default.

2. Live end-to-end (e2e) integration tests — exercise the MCP tools against a real Monarch account to verify they handle the live API robustly (adversarial/edge inputs, server-side error paths). They are opt-in and never run in CI:

Prerequisites: a stored keyring token (run python login_setup.py once), or MONARCH_EMAIL / MONARCH_PASSWORD in the environment. Without these, the suite skips. The tests create and delete data prefixed with MCP-Test- and self-clean (a post-suite sweep removes any residue). See tests/integration/README.md for details and safety notes.

There is also a separate agent test skill (.claude/skills/test-monarch-mcp/) that drives an AI agent to verify it calls the tools correctly — distinct from the two pytest suites above.

🙏 Acknowledgments

Forked from @robcerda's monarch-mcp-server, maintained by vargahis.

Built on the monarchmoneycommunity Python library.

Thanks to:

@robcerda for the original MCP server
@hammem for the original monarchmoney library
@bradleyseanf for the community fork

License

MIT License

Source: README.md at commit 7299fdc

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.4LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts