monarch-money-mcp-server — Claude Code skill: what it does
A skill that runs a Monarch Money MCP server, so an agent can read accounts, transactions, budgets and categories and add new entries.
no license 161 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill monarch-money-mcp-server -a claude-codeWhat monarch-money-mcp-server does
Under the hood sits a Python server built on the MonarchMoneyCommunity library, multi-factor login included. Tools cover accounts and investment holdings, transaction search with date, account and category filters, budgets, and category groups. Writes are there too: adding a transaction, editing one, assigning a category, setting a budget amount for future months.
Signing in happens once, by hand. You start login_setup.py from a terminal, outside the agent, and type email, password and 2FA code. The session token is kept and lasts for weeks. Google and SSO users paste a browser token into monarch_login_with_token instead, and skip that step at your peril: without a token the server has nothing to read.
Wiring lives in claude_desktop_config.json, ~/.claude.json, or a project-level .mcp.json. Every path to server.py has to be absolute. Dependencies come from pip install -r requirements.txt plus pip install -e ., or a single uv sync.
What it helps with
- check balances across every linked account
- pull transactions for a date range and category
- set a category budget for upcoming months
- sort uncategorized spending into groups
- record a cash purchase by hand
Example prompts for the agent
- What are my balances across all Monarch accounts?
- Pull every Amazon charge from January 2024
- Set my dining budget to 500.00 a month from February, applied to future months
How to install monarch-money-mcp-server
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill monarch-money-mcp-server -a claude-code2Manually: put the files in place
~/.claude/skills/monarch-money-mcp-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/monarch-money-mcp-server/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill monarch-money-mcp-server -a codex2Manually: put the files in place
.agents/skills/monarch-money-mcp-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill monarch-money-mcp-server -a cursor2Manually: put the files in place
.cursor/skills/monarch-money-mcp-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/monarch-money-mcp-server2Manually: put the files in place
.github/skills/monarch-money-mcp-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill monarch-money-mcp-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/monarch-money-mcp-serverManually: put the files in place
.devin/skills/monarch-money-mcp-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill monarch-money-mcp-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about monarch-money-mcp-server
How do I install monarch-money-mcp-server in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill monarch-money-mcp-server -a claude-code. The skill lands at ~/.claude/skills/monarch-money-mcp-server/SKILL.md.
What does monarch-money-mcp-server do?
It connects the agent to Monarch Money over MCP: balances, transactions, budgets and categories can be read, and transactions created or edited.
Do I need a 2FA code to sign in?
Yes, when multi-factor is enabled on the account: login_setup.py asks for email, password and the code. SSO and Google users paste a browser session token into monarch_login_with_token instead.