Monarch Money MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Monarch Money MCP Server
An MCP server that connects Claude (and other MCP clients) to your Monarch Money financial data. Query accounts, transactions, and budgets, or update transactions and budget amounts — all through natural language.
Features
Tool | Description |
| List all linked financial accounts with balances and types |
| Query transactions with filters (limit, date range, search) |
| Get per-category budget vs. actual spending for a date range |
| List all transaction categories with IDs and group names |
| Set a monthly budget amount for a category |
| Update a transaction's category, merchant, notes, etc. |
Most read tools support a verbosity parameter (ultra-light, light, or standard) to control how much data is returned.
Related MCP server: monarch-mcp
Prerequisites
Python 3.10+
A Monarch Money account
Claude Code or Claude Desktop (or any MCP client)
Installation
From GitHub
pip install git+https://github.com/ezra-quemuel/monarch-mcp.gitFrom source
git clone https://github.com/ezra-quemuel/monarch-mcp.git
cd monarch-mcp
pip install -e .Configuration
Environment Variables
Variable | Required | Description |
| Yes | Your Monarch Money email |
| Yes | Your Monarch Money password |
| No | TOTP secret for MFA (base32 string from authenticator setup) |
Claude Code
claude mcp add monarch-money \
-e MONARCH_EMAIL=your-email@example.com \
-e MONARCH_PASSWORD=your-password \
-e MONARCH_MFA_SECRET=your-totp-secret \
-- monarch-mcpClaude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"monarch-money": {
"command": "monarch-mcp",
"env": {
"MONARCH_EMAIL": "your-email@example.com",
"MONARCH_PASSWORD": "your-password",
"MONARCH_MFA_SECRET": "your-totp-secret"
}
}
}
}If you installed from source with a virtual environment, use the full path to the monarch-mcp binary (e.g., /path/to/monarch-mcp/.venv/bin/monarch-mcp).
Known Issues
gql must be pinned to <4.0
The monarchmoney library depends on gql, but gql 4.0 changed the signature of execute_async in a breaking way. This project pins gql<4.0 in its dependencies to avoid this.
Domain rebrand (monarchmoney.com -> monarch.com)
Monarch rebranded their API domain from api.monarchmoney.com to api.monarch.com. The monarchmoney library hasn't been updated yet. This server patches MonarchMoney.BASE_URL at runtime to fix this automatically — no manual action needed.
Budget goals fields
The monarchmoney library's GraphQL query for get_budgets references goals-related fields that no longer exist in the API schema. This server works around this by passing use_legacy_goals=False, use_v2_goals=False. If you still encounter errors, you may need to manually edit the installed monarchmoney library to remove the goals fields from the budget query. Look for the get_budgets query in monarchmoney/__init__.py or the relevant query file and remove the goals { ... } block.
Contributing
Contributions are welcome! Please open an issue or pull request on GitHub.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Query your real net worth, spending, transactions, budgets and portfolio from any MCP client.
Personal finance for AI agents — onboard, import statements, categorize & budget over MCP.
Read-only finance MCP server. Connects your banks, cards, payment apps, books and payroll into one ledger for your AI. Can't move money. Open source (AGPL-3.0), free during beta.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server that provides access to personal financial data from Monarch Money, allowing users to retrieve account information, transactions, budgets, goals, and net worth through natural language queries.16-
- FlicenseBqualityDmaintenanceMCP server that bridges Claude to Monarch Money for personal-finance analysis and lightweight edits.18-
- FlicenseNot gradedqualityDmaintenanceAn MCP server that integrates with Monarch Money to provide financial data access and operations, including account management, transaction filtering, budget analysis, and goal tracking through natural language.-
- AlicenseCqualityCmaintenanceUnofficial MCP server for Monarch Money that exposes tools for managing accounts, transactions, budgets, and other financial data through natural language.1251MIT