monarch-mcp
Monarch Money MCP 服务器
一个用于通过 Claude Desktop 与 Monarch Money 个人理财平台集成的模型上下文协议 (MCP) 服务器。
概览
设计安全 — 基于浏览器的登录,令牌存储在 OS 钥匙串中(绝不存储在配置文件或环境变量中)
默认安全 — 只读模式可防止意外更改;写入工具需要明确选择启用
功能全面 — 37 个工具,涵盖账户、交易、拆分、预算、现金流、标签、类别和信用记录
易于安装 — Claude Desktop 扩展 (
.mcpb)、uvx或pip
两种运行模式:
服务器默认以 只读模式 启动。在您明确选择启用之前,写入工具将被隐藏并禁用。
只读(默认) | 写入模式 | |
查看 账户、交易、预算 | 是 | 是 |
分析 现金流、支出、净资产 | 是 | 是 |
创建 交易、标签、类别 | 否 | 是 |
更新 账户、预算、拆分 | 否 | 是 |
删除 交易、标签、账户 | 否 | 是 |
Related MCP server: Monarch Money MCP Server
快速入门
安装
选项 1:Claude Desktop 扩展 (.mcpb) — 推荐用于 Claude Desktop
允许直接从 Claude Desktop 应用中切换写入模式的开启/关闭。
从 Releases 下载最新的
.mcpb文件在 Claude Desktop 中:设置 > 扩展 > 高级设置 > 安装扩展 — 选择
.mcpb文件重启 Claude Desktop
要启用写入工具:设置 > 扩展 > Monarch Money MCP Server > 配置 — 切换 “启用写入工具” 并点击 保存。
选项 2:uvx(无需安装) — 推荐用于代理(例如 Claude Code 或 Cursor)
也适用于 Claude Desktop,但无法从应用内切换写入模式 — 请在配置中设置。
添加到您的 MCP 配置文件中:
{
"mcpServers": {
"Monarch Money": {
"command": "uvx",
"args": ["monarch-mcp"]
}
}
}要启用写入工具:
{
"mcpServers": {
"Monarch Money": {
"command": "uvx",
"args": ["monarch-mcp", "--enable-write"]
}
}
}选项 3:pip 安装 — 推荐用于本地安装和 venv
pip install monarch-mcp贡献者:请参阅 docs/releasing.md 了解发布流程、版本方案以及通过 TestPyPI 进行的预发布测试。
使用 Python 解释器的完整路径添加到您的 MCP 配置中:
{
"mcpServers": {
"Monarch Money": {
"command": "/path/to/bin/python3",
"args": ["-m", "monarch_mcp"]
}
}
}要启用写入工具,请在 args 中添加 "--enable-write"。
选项 4:克隆并安装 — 推荐用于开发
git clone https://github.com/vargahis/monarch-mcp.git
cd monarch-mcp
pip install -e .然后使用开发环境中的 Python 解释器添加到您的 MCP 配置中:
{
"mcpServers": {
"Monarch Money": {
"command": "/path/to/bin/python3",
"args": ["-m", "monarch_mcp"]
}
}
}要启用写入工具,请在 args 中添加 "--enable-write"。
身份验证
当 MCP 服务器首次启动且没有保存的会话时,身份验证会 在您的浏览器中自动进行。
启动(或重启)Claude Desktop
服务器检测到没有令牌,并在您的浏览器中打开登录页面
输入您的 Monarch Money 电子邮件和密码
如果启用了 MFA,请输入您的 2FA 代码
身份验证成功后,令牌将保存到您的系统钥匙串中 — 一切就绪
关键细节:
凭据仅在您的浏览器中输入 — 绝不会通过 Claude Desktop 输入
令牌存储在 OS 钥匙串中 — 在重启后保持有效,有效期为数周/数月
过期的会话会自动重新验证 — 下次调用工具时会重新触发浏览器登录
完全支持 MFA
备选方案:在终端中运行
python login_setup.py以用于无头环境
有关身份验证架构的技术细节,请参阅 docs/authentication.md。
使用示例
Show me all my financial accountsWhat were my last 50 transactions?How's my budget looking this month?Analyze my cashflow for the last 3 monthsCreate a tag called "Business Expenses" in red可用工具
工具 | 描述 | 模式 |
Auth | ||
| 获取设置说明 | read |
| 检查身份验证状态 | read |
| 调试钥匙串问题 | read |
Accounts | ||
| 获取所有金融账户 | read |
| 获取投资持仓 | read |
| 获取历史余额数据 | read |
| 获取每日余额 | read |
| 按账户类型计算净资产 | read |
| 每日总净值 | read |
| 获取关联机构 | read |
| 获取有效的账户类型 | read |
| 请求账户数据刷新 | read |
| 创建手动账户 | write |
| 更新账户设置 | write |
| 删除账户 | write |
Transactions | ||
| 获取带有过滤条件的交易(日期、账户、类别、标签、搜索、待审核等) | read |
| 获取完整的交易详情 | read |
| 汇总交易统计信息 | read |
| 获取拆分信息 | read |
| 获取定期交易 | read |
| 创建新交易 | write |
| 更新现有交易 | write |
| 删除交易 | write |
| 创建/修改/删除拆分 | write |
Tags | ||
| 获取所有标签 | read |
| 创建新标签 | write |
| 删除标签 | write |
| 设置交易标签 | write |
Categories | ||
| 获取所有类别 | read |
| 获取类别组 | read |
| 创建类别 | write |
| 删除类别 | write |
Budgets & Cashflow | ||
| 获取预算信息 | read |
| 获取现金流分析 | read |
| 获取现金流摘要 | read |
| 设置类别预算 | write |
Other | ||
| 获取订阅状态 | read |
| 获取信用评分历史 | read |
🙏 致谢
派生自 @robcerda 的 monarch-mcp-server,由 vargahis 维护。
基于 monarchmoneycommunity Python 库构建。
感谢:
@robcerda 提供原始 MCP 服务器
@hammem 提供原始 monarchmoney 库
@bradleyseanf 提供社区分支
许可证
MIT 许可证
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to access and analyze MonarchMoney personal finance data through natural language queries. Provides comprehensive financial insights including account balances, transaction analysis, budget tracking, and spending patterns with enterprise-grade security.9MIT
- AlicenseAqualityDmaintenanceEnables integration with Monarch Money to query financial data, analyze spending patterns, track budgets, and get personalized financial insights through conversational AI with Claude Desktop.113ISC
- AlicenseNot gradedqualityFmaintenanceProvides read-only access to Monarch Money financial data, enabling AI assistants to analyze transactions, budgets, and cashflow.4MIT
- AlicenseNot gradedqualityCmaintenanceA Model Context Protocol (MCP) server that enables AI assistants to interact with your Monarch Money personal finance data. Manage accounts, transactions, budgets, and analyze your finances programmatically.MIT
Related MCP Connectors
Brazilian Open Finance MCP — 30+ banks (Itaú, Nubank, etc.) to Claude/Cursor. Read-only.
Read-only bank access for your AI agent. Connects Claude, ChatGPT, Cursor, Gemini, Codex.
Connect AI agents to bank accounts, transactions, balances, and investments.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/vargahis/monarch-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server