Skip to main content
Glama
vargahis

monarch-mcp

by vargahis

Monarch Money MCP 服务器

一个用于通过 Claude Desktop 与 Monarch Money 个人理财平台集成的模型上下文协议 (MCP) 服务器。

概览

  • 设计安全 — 基于浏览器的登录,令牌存储在 OS 钥匙串中(绝不存储在配置文件或环境变量中)

  • 默认安全 — 只读模式可防止意外更改;写入工具需要明确选择启用

  • 功能全面 — 37 个工具,涵盖账户、交易、拆分、预算、现金流、标签、类别和信用记录

  • 易于安装 — Claude Desktop 扩展 (.mcpb)、uvxpip

两种运行模式:

服务器默认以 只读模式 启动。在您明确选择启用之前,写入工具将被隐藏并禁用。

只读(默认)

写入模式

查看 账户、交易、预算

分析 现金流、支出、净资产

创建 交易、标签、类别

更新 账户、预算、拆分

删除 交易、标签、账户

Related MCP server: Monarch Money MCP Server

快速入门

安装

选项 1:Claude Desktop 扩展 (.mcpb) — 推荐用于 Claude Desktop

允许直接从 Claude Desktop 应用中切换写入模式的开启/关闭。

  1. Releases 下载最新的 .mcpb 文件

  2. 在 Claude Desktop 中:设置 > 扩展 > 高级设置 > 安装扩展 — 选择 .mcpb 文件

  3. 重启 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 服务器首次启动且没有保存的会话时,身份验证会 在您的浏览器中自动进行

  1. 启动(或重启)Claude Desktop

  2. 服务器检测到没有令牌,并在您的浏览器中打开登录页面

  3. 输入您的 Monarch Money 电子邮件和密码

  4. 如果启用了 MFA,请输入您的 2FA 代码

  5. 身份验证成功后,令牌将保存到您的系统钥匙串中 — 一切就绪

关键细节:

  • 凭据仅在您的浏览器中输入 — 绝不会通过 Claude Desktop 输入

  • 令牌存储在 OS 钥匙串中 — 在重启后保持有效,有效期为数周/数月

  • 过期的会话会自动重新验证 — 下次调用工具时会重新触发浏览器登录

  • 完全支持 MFA

  • 备选方案:在终端中运行 python login_setup.py 以用于无头环境

有关身份验证架构的技术细节,请参阅 docs/authentication.md

使用示例

Show me all my financial accounts
What were my last 50 transactions?
How's my budget looking this month?
Analyze my cashflow for the last 3 months
Create a tag called "Business Expenses" in red

可用工具

工具

描述

模式

Auth

setup_authentication

获取设置说明

read

check_auth_status

检查身份验证状态

read

debug_session_loading

调试钥匙串问题

read

Accounts

get_accounts

获取所有金融账户

read

get_account_holdings

获取投资持仓

read

get_account_history

获取历史余额数据

read

get_recent_account_balances

获取每日余额

read

get_account_snapshots_by_type

按账户类型计算净资产

read

get_aggregate_snapshots

每日总净值

read

get_institutions

获取关联机构

read

get_account_type_options

获取有效的账户类型

read

refresh_accounts

请求账户数据刷新

read

create_manual_account

创建手动账户

write

update_account

更新账户设置

write

delete_account

删除账户

write

Transactions

get_transactions

获取带有过滤条件的交易(日期、账户、类别、标签、搜索、待审核等)

read

get_transaction_details

获取完整的交易详情

read

get_transactions_summary

汇总交易统计信息

read

get_transaction_splits

获取拆分信息

read

get_recurring_transactions

获取定期交易

read

create_transaction

创建新交易

write

update_transaction

更新现有交易

write

delete_transaction

删除交易

write

update_transaction_splits

创建/修改/删除拆分

write

Tags

get_transaction_tags

获取所有标签

read

create_transaction_tag

创建新标签

write

delete_transaction_tag

删除标签

write

set_transaction_tags

设置交易标签

write

Categories

get_transaction_categories

获取所有类别

read

get_transaction_category_groups

获取类别组

read

create_transaction_category

创建类别

write

delete_transaction_category

删除类别

write

Budgets & Cashflow

get_budgets

获取预算信息

read

get_cashflow

获取现金流分析

read

get_cashflow_summary

获取现金流摘要

read

set_budget_amount

设置类别预算

write

Other

get_subscription_details

获取订阅状态

read

get_credit_history

获取信用评分历史

read

🙏 致谢

派生自 @robcerdamonarch-mcp-server,由 vargahis 维护。

基于 monarchmoneycommunity Python 库构建。

感谢:

许可证

MIT 许可证

Install Server
A
license - permissive license
B
quality
B
maintenance

Maintenance

Maintainers
Response time
3wRelease cycle
15Releases (12mo)
Commit activity
Issues opened vs closed

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

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables 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.
    9
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables integration with Monarch Money to query financial data, analyze spending patterns, track budgets, and get personalized financial insights through conversational AI with Claude Desktop.
    11
    3
    ISC
  • A
    license
    Not graded
    quality
    F
    maintenance
    Provides read-only access to Monarch Money financial data, enabling AI assistants to analyze transactions, budgets, and cashflow.
    4
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    A 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

View all related MCP servers

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.

View all MCP Connectors

Latest Blog Posts

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