Monarch Money MCP 服务器

这是一个提供访问 Monarch Money 财务数据和操作的 MCP（模型上下文协议）服务器。

功能

• 账户管理：列出并检索账户信息
• 交易操作：按日期范围、账户和类别筛选获取交易
• 预算分析：访问预算数据和消费洞察
• 分类管理：列出并管理交易类别
• 目标跟踪：访问财务目标及其进度
• 净资产跟踪：检索随时间变化的净资产快照

安装

1. 克隆或下载此 MCP 服务器
2. 安装依赖项：

   cd /path/to/monarch-money-mcp
   uv sync
   

配置

在你的 .mcp.json 配置文件中添加服务器：

{
  "mcpServers": {
    "monarch-money": {
      "command": "/path/to/uv",
      "args": [
        "--directory", 
        "/path/to/monarch-money-mcp",
        "run",
        "python",
        "server.py"
      ],
      "env": {
        "MONARCH_EMAIL": "your-email@example.com",
        "MONARCH_PASSWORD": "your-password",
        "MONARCH_MFA_SECRET": "your-mfa-secret-key"
      }
    }
  }
}

重要提示：

• 将 /path/to/uv 替换为你 uv 可执行文件的完整路径（通过 which uv 查找）
• 将 /path/to/monarch-money-mcp 替换为此服务器目录的绝对路径
• 使用绝对路径，而不是相对路径

获取您的 MFA 密钥

1. 前往 Monarch Money 设置并启用 2FA
2. 当显示二维码时，查找“无法扫描？”或“手动输入”选项
3. 复制密钥（它将是一个字符串，如 T5SPVJIBRNPNNINFSH5W7RFVF2XYADYX）
4. 将其作为你的 MONARCH_MFA_SECRET

可用工具

get_accounts

列出所有账户及其余额和详细信息。

get_transactions

获取交易，可选过滤：

• start_date：从该日期开始筛选交易（YYYY-MM-DD）
• end_date：到该日期结束筛选交易（YYYY-MM-DD）
• account_ids：要筛选的账户 ID 列表
• category_ids：要筛选的类别 ID 列表
• limit：返回的最大交易数

get_categories

列出所有交易类别。

get_budgets

获取预算信息和消费分析。

get_goals

列出财务目标及其进度。

get_cashflow

获取现金流数据以进行收入和支出分析。

get_investments

获取投资账户详情及表现。

get_net_worth

获取随时间变化的净资产快照。

使用示例

基本账户信息

使用 get_accounts 工具查看我的所有账户及其当前余额。

交易分析

使用 get_transactions 工具获取 2024 年 1 月的所有交易，设置 start_date 为 "2024-01-01" 和 end_date  为 "2024-01-31"。

预算跟踪

使用 get_budgets 工具显示我当前的预算状态。

会话管理

服务器自动管理身份验证会话：

• 会话缓存在 .mm 目录中，以便更快地后续登录
• 自动创建和管理会话缓存
• 如果需要，可以在 env 部分使用 MONARCH_FORCE_LOGIN=true 强制重新登录

故障排除

MFA 问题

• 确保你的 MFA 密钥正确且格式正确
• 尝试在你的 .mcp.json env 部分设置 MONARCH_FORCE_LOGIN=true
• 检查系统时间是否准确（TOTP 所需）

连接问题

• 验证 .mcp.json 中的电子邮件和密码是否正确
• 检查互联网连接
• 尝试直接运行服务器以查看详细的错误消息：

  uv run server.py
  

会话问题

• 删除 .mm 目录以清除缓存的会话
• 在你的 .mcp.json env 部分暂时设置 MONARCH_FORCE_LOGIN=true

致谢

MCP 服务器

• 作者：Taurus Colvin (@colvint)
• 描述：Monarch Money 的 MCP（模型上下文协议）服务器封装

MonarchMoney Python 库

• 作者：hammem (@hammem)
• 仓库：https://github.com/hammem/monarchmoney
• 许可证：MIT 许可证
• 描述：提供 Monarch Money API 访问的基础 Python 库

此 MCP 服务器封装了 monarchmoney Python 库，以通过模型上下文协议实现与 AI 助手的无缝集成。

安全注意事项

• 在你的 .mcp.json 文件中安全保存凭证
• MFA 密钥提供了对账户的完全访问权限——将其视为密码
• .mm 目录中的会话文件包含认证令牌——确保它们的安全
• 考虑限制对你的 .mcp.json 文件的访问，因为它包含敏感凭证