OpenBudget MCP Server

OpenBudget MCP Server

你的银行账户、支出、债务和投资均可供 AI 助手使用。

OpenBudget 是一个托管的 Model Context Protocol（MCP）服务，可让 Claude、ChatGPT、Cursor、Codex 和其他 MCP 客户端访问你的财务数据。这包括通过 Plaid 从美国金融机构同步的交易、余额、净资产、信用卡、贷款、抵押贷款、投资持仓和投资活动。你也可以添加自己跟踪的现金、礼品卡余额、房地产、非上市公司权益及其他资产。

你无需运行任何东西。该服务托管在 OpenBudget 的基础设施上。只需向客户端添加一个 URL、登录一次，即可开始提问。

https://api.openbudget.sh/mcp

• 传输方式： Streamable HTTP（远程 MCP 服务）
• 身份验证： OAuth 2.0；使用你的 OpenBudget 账户登录
• 套餐： Base 年费为 $60，按月付费为 $9.95。Investor 年费为 $99，按月付费为 $12.95。两种套餐均提供 7 天免费试用。
• 数据： 通过 Plaid 连接的你自己的银行、券商和退休账户，以及你自行添加的资产和活动

Plaid 连接仅提供只读财务数据。OpenBudget 绝不会存储你的金融机构凭据，AI 助手无法转移资金或进行交易。所有写入操作都仅限于你的 OpenBudget 账户内：分类、备注、规则、手动账户、自定义持仓和自定义活动。

---

快速连接

选择下方的客户端，或查看完整的分步指南：openbudget.sh/connect-ai。

Claude（claude.ai / Claude Desktop）

1. Customize → Connectors → Add custom connector
2. 将其命名为 openbudget.sh，粘贴 https://api.openbudget.sh/mcp
3. 点击 Connect，然后使用你关联银行时所用的账户登录

完整指南：openbudget.sh/connect-ai/claude

Claude Code

claude mcp add --transport http openbudget https://api.openbudget.sh/mcp

添加 --scope user，即可在每个项目中使用。然后在会话中运行 /mcp，选择 openbudget，再选择 Authenticate。

完整指南：openbudget.sh/connect-ai/claude-code

ChatGPT（Plus / Team / Enterprise）

1. Settings → Apps → Advanced settings → 启用 Developer mode
2. Create app，将其命名为 OpenBudget，粘贴 URL，选择 OAuth
3. 登录并授权访问

完整指南：openbudget.sh/connect-ai/chatgpt

Cursor

添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）：

{
  "mcpServers": {
    "openbudget": {
      "url": "https://api.openbudget.sh/mcp"
    }
  }
}

然后在 Cursor Settings → Tools & MCP → Connect 下启用该服务。

完整指南：openbudget.sh/connect-ai/cursor

Codex / Codex CLI

codex mcp add openbudget --url https://api.openbudget.sh/mcp
codex mcp login openbudget

或者添加到 ~/.codex/config.toml：

[mcp_servers.openbudget]
url = "https://api.openbudget.sh/mcp"

完整指南：codex · codex-cli

其他 MCP 客户端

添加一个通过 Streamable HTTP 传输的远程 / 自定义 MCP 服务，并指向 https://api.openbudget.sh/mcp。大多数客户端也接受上文 Cursor 部分所示的 mcpServers JSON 格式。首次调用时会打开浏览器，让你登录并批准访问。

完整指南：openbudget.sh/connect-ai/other

---

你可以询问的内容

该服务包含 22 个工具，每个工具都在 openbudget.sh/tools 提供实时演示。你很少需要按名称调用它们。用自然语言提问，客户端会选择合适的工具。

基础工具

工具	功能
list_accounts	列出所有已关联账户及其余额、金融机构和标准化净资产视图。
search_transactions	按文本、类别、账户、日期范围或金额搜索和筛选交易；Plaid 提供相关信息时，还会包含结算关联和商户位置详情。
get_liabilities	信用卡、学生贷款和抵押贷款：年利率、到期日、最低还款额和还款数据。
get_liability_history	查看这些负债随时间的变化，包括年利率变动、余额趋势和年初至今的利息。
list_available_categories	完整的交易类别分类体系。
list_categorization_rules	按评估顺序列出你的自动分类规则。
update_transaction	(写入) 重新为交易分类、添加备注、拆分交易，或将其从搜索结果中隐藏。
create_transaction	(写入) 记录使用实体现金、礼品卡或商店额度进行的银行账户之外的消费。
delete_transaction	(写入) 删除手动创建的交易（银行交易则通过 update_transaction 隐藏）。
upsert_manual_account	(写入) 创建或更新银行账户之外的手动账户，例如现金钱包或礼品卡余额。
save_categorization_rule	(写入) 创建规则，例如“付给我们保姆的款项属于育儿支出”，后续交易将自动遵循该规则。
delete_categorization_rule	(写入) 删除规则。
update_liability	(写入) 为信用卡或贷款添加备注，或手动覆盖余额。

投资者工具

投资者版包含所有基础工具，并额外提供以下工具。

工具	功能
search_investment_holdings	按账户、股票代码、名称、类别、来源或是否已平仓筛选已关联和自定义持仓，然后按价值、数量、名称或股票代码排序。返回 AI 计算资产配置、收益和集中度所需的持仓数据。
search_investment_transactions	搜索买入、卖出、股息、利息、缴款、提款、费用、税款、房产活动和调整。
list_available_investment_categories	返回持仓和投资活动各自独立的类别分类体系。
update_investment_holding	(写入) 为持仓分类、更改其显示字段或管理备注。自定义持仓还支持更改价值、数量、价格、成本基础、股票代码、货币和状态。
update_investment_transaction	(写入) 为投资活动分类、添加备注或忽略该活动。自定义活动还支持更改金额、日期、数量、价格、费用、股票代码和货币。
create_investment_holding	(写入) 添加房地产、私人公司权益、收藏品、线下持仓或其他自定义资产。
delete_investment_holding	(写入) 删除自定义持仓。已关联持仓仍会从金融机构同步。
create_investment_transaction	(写入) 添加房产购买、分配、私人缴款、费用、估值调整及其他自定义投资活动。
delete_investment_transaction	(写入) 删除自定义投资活动。已关联的活动可以改为忽略。

交易结果可能包含 pendingTransactionId，用于将已入账交易关联到其先前的待处理记录；也可能包含结构化的 location，其中包括地址、城市、地区、邮政编码、商店编号、纬度和经度。如果小费或预授权导致结算金额发生变化，这些字段可确保可靠地核对收据。

示例提示词

• “我上个月在餐厅花了多少钱？和前一个月相比如何？”
• “我 3 月去丹佛的行程总共花了多少钱：机票、酒店、餐饮和网约车？”
• “找出我正在付费的所有订阅，并计算每月总额。”
• “我目前所有账户的净资产是多少？”
• “我的每张信用卡的 APR 是多少？下一次还款何时到期？”
• “将付给 Elena 的 Venmo 款项归类为托儿费，并将其设为规则。”
• “我今晚用现金付给保姆 60 美元；将其记录为托儿费。”
• “追踪我的 200 美元 Amazon 礼品卡，并记录我刚从中消费的 45 美元。”
• “我的银行账户、信用卡、贷款、经纪账户、退休账户和房产的净资产总额是多少？”
• “过去三个月里，我花了多少钱、存了多少钱、投资了多少钱？每个月之间有哪些变化？”
• “添加我的出租房产，并记录本月的分配款。”

更多示例请参见 examples/prompts.md。

---

只读金融连接

银行、经纪账户和退休账户均通过 Plaid 连接，且只能读取数据。OpenBudget 不会获取或存储你的金融机构凭据。你的 AI 助手无法转移资金、发起转账、下达交易指令，也无法修改你在金融机构中的任何信息。 所有写入操作都只发生在你的 OpenBudget 账户内：交易和投资分类、备注、忽略标记、拆分、规则、负债覆盖项、手动账户、自定义持仓和自定义活动。每个工具都声明了 MCP 注解（readOnlyHint、destructiveHint），以便客户端展示每次调用的作用。

隐私与条款

OAuth 授权你的 AI 客户端访问你在 OpenBudget 中的个人财务数据。请参阅服务条款、隐私政策和安全页面。

许可证

本仓库中的配置片段和文档采用 MIT 许可证。

OpenBudget MCP 服务由其服务条款托管并管理。MIT 许可证仅适用于本仓库中的配置片段和文档。本仓库不包含服务器的源代码。

链接

• 网站：openbudget.sh
• 工具演示：openbudget.sh/tools
• 连接指南：openbudget.sh/connect-ai
• 定价：openbudget.sh/pricing
• 模型上下文协议：modelcontextprotocol.io