Monarch Money MCP Server 是一个基于 Model Context Protocol（MCP）的服务器，旨在为 AI 助手（如 Claude Desktop）提供对 Monarch Money 财务数据的只读访问，以便分析财务信息、交易、预算和现金流数据。该工具由个人开发者在 GitHub 上开源，作者声明是出于个人兴趣和学习目的创建，与 Monarch Money 官方无关联，且因无修改数据需求，当前仅支持只读操作。
主要能力包括：只读访问 Monarch Money 账户；支持按日期范围和搜索进行交易分析；预算跟踪与现金流分析；账户详情查询（含投资持仓）；支持 MFA（多因素认证）的安全认证；会话持久化以减少重复认证。
使用方式方面：需要 uv 包管理器（推荐）和 Monarch Money 账户。安装步骤包括克隆仓库、使用 uv 安装依赖（uv add mcp monarchmoney python-dotenv）、配置环境变量（复制 .env.example 为 .env，并填入 MONARCH_EMAIL、MONARCH_PASSWORD、MONARCH_MFA_SECRET 等凭据）、测试连接（python test_api.py）和启动 MCP 服务器。可与 Claude Desktop 集成，在 claude_desktop_config.json 中添加配置。
可用资源包括：monarch://accounts（所有已关联账户）、monarch://transactions/recent（最近 100 条交易）、monarch://budgets（预算信息，含实际与目标对比）、monarch://cashflow/summary（收入、支出和储蓄摘要）。可用工具包括：get_transactions（按日期范围筛选交易）、get_account_details（详细账户信息，含持仓）、get_cashflow_analysis（按类别和时间段分析现金流）、search_transactions（按描述或商户搜索交易）、get_categories（所有交易类别）、get_institutions（已关联金融机构）。
示例提示词包括：“显示我上个月的近期交易”、“我当前的预算状态如何？”、“按类别分析我的支出模式”、“今年我在杂货上花了多少钱？”、“我的投资账户余额是多少？”。
安全与限制：服务器为只读，无写入操作；登录凭据保留在本地机器；支持会话缓存以减少认证频率；推荐使用 MFA 双因素认证。故障排除方法包括：运行调试脚本 python debug_server.py、检查环境变量、清除会话缓存（rm -rf .mm/）、设置 MONARCH_MFA_SECRET 环境变量、删除 .mm/ 目录强制重新登录、确保依赖安装。
项目结构、测试方法（安装测试依赖、运行单元测试套件、覆盖率测试、手动 API 测试）以及贡献指南（fork 仓库、创建特性分支、修改、测试、提交拉取请求）也在文档中提及。采用 MIT 许可证。作者提醒使用风险自负，并确保遵守 Monarch Money 的服务条款。
