ynab-mcp-server

ynab-mcp-server

通过托管 MCP 服务将 YNAB 连接到 ChatGPT 或 Claude。

如果你想让 AI 助手在使用自己的 YNAB 账户登录后，读取和管理 YNAB 计划、类别、交易和目标，并查看余额和净资产，请使用此服务。

所需内容

• YNAB 账户
• 托管 MCP URL：https://mcpforynab.smirnovlabs.com/mcp
• 支持自定义 MCP 连接器的 ChatGPT 或 Claude

快速开始

1. 获取托管 MCP URL。
2. 在 ChatGPT 或 Claude 中添加该 URL。
3. 点击 Connect。
4. 出现提示时，使用 YNAB 登录。
5. 返回聊天并开始询问 YNAB 相关问题。

在 Claude 中，页面顶部的 添加到 Claude 按钮会完成步骤 1 和 2。请参阅在 Claude 中设置。

在 ChatGPT 中设置

以下步骤适用于 ChatGPT 网页应用。

截至 2026 年 3 月 25 日，OpenAI 要求启用开发者模式才能使用自定义 MCP 连接器。

开始之前

• 你需要使用支持自定义 MCP 连接器的 ChatGPT 套餐。
• 如果你使用的是工作区套餐，管理员可能需要先启用开发者模式。
• 你需要此托管 MCP URL：https://mcpforynab.smirnovlabs.com/mcp。

分步说明

1. 打开 chatgpt.com。
2. 打开 Settings。
3. 如果尚未启用开发者模式，请先启用。
4. 前往 Apps 或 Connectors，然后选择创建自定义应用或连接器。
5. 粘贴托管 MCP URL。
6. 如果 ChatGPT 询问身份验证方式，请选择 OAuth。
7. 保存或创建连接器。
8. 开始新的聊天。
9. 打开工具菜单并启用新的连接器。
10. 页面跳转后，使用 YNAB 登录并批准访问。
11. 返回 ChatGPT 并发送测试提示词。

推荐的入门提示词

• Show me the balances of all my plan accounts.
• List my plan categories with available amounts.
• Find my most recent grocery transactions.
• What were my largest spending categories last month?

在 Claude 中设置

以下步骤适用于 claude.ai。

截至 2026 年 10 月 25 日，Claude 将自定义连接器放在 Customize > Connectors 中。

开始之前

• Free、Pro、Max、Team 和 Enterprise 套餐均支持自定义连接器。Free 套餐允许添加一个。
• 托管 MCP URL 为 https://mcpforynab.smirnovlabs.com/mcp。添加到 Claude 按钮会自动填入。
• 对于 Claude Team 或 Enterprise，组织 Owner 需要先添加连接器。

Claude Free、Pro 或 Max 分步说明

1. 点击本页面顶部的 添加到 Claude。
2. 如果出现提示，请登录 Claude。
3. Claude 会打开 Add custom connector 对话框，填好各项内容，并提示这些值来自外部链接。请检查名称为 YNAB，URL 为 https://mcpforynab.smirnovlabs.com/mcp。
4. 如果对话框中显示 Authentication 和 OAuth client 设置，请选择 Sign in now 和 Register automatically。此服务不支持 Use Claude's published identity。
5. 点击 Add。
6. 点击 Connect。
7. 页面跳转后，使用 YNAB 登录并批准访问。
8. 开始新的聊天。
9. 点击 +，选择 Connectors，然后启用 YNAB。
10. 发送测试提示词。

如需手动添加连接器，请前往 Customize > Connectors 并点击 Add custom connector。输入名称 YNAB 和托管 MCP URL，然后从步骤 4 继续。

Claude Team 或 Enterprise 的分步说明

组织所有者只需添加一次连接器。之后，每位成员连接自己的 YNAB 账户。

对于所有者：

1. 打开组织安装链接。Claude 会打开组织的 Add custom connector 对话框，并填好名称和 URL。
2. 如果对话框显示 Authentication 和 OAuth client 设置，请选择 Sign in now 和 Register automatically。
3. 点击 Add。

若要手动添加，请前往 Organization settings > Connectors，选择 Add，然后选择 Custom。输入名称 YNAB 和托管 MCP URL，然后从第 2 步继续。

对于每位成员：

1. 前往 Customize > Connectors。
2. 找到所有者添加的连接器。它带有 Custom 标签。
3. 点击 Connect。
4. 重定向后，使用 YNAB 登录并批准访问权限。
5. 开始新的聊天。
6. 点击 +，选择 Connectors，然后启用该连接器。
7. 发送测试提示词。

适合入门的提示词

• Show me my current account balances in YNAB.
• What categories are overspent right now?
• Find transactions from Amazon in the last 30 days.
• Summarize my spending by category this month.

连接后会发生什么

1. ChatGPT 或 Claude 连接到托管 MCP URL。
2. MCP 服务将你带到 YNAB 登录页面。
3. 你批准访问自己的 YNAB 账户。
4. 服务会存储代表你发出后续 YNAB 请求所需的 OAuth 令牌。
5. 随后，你的助手便可在聊天中使用 YNAB 工具和资源。

可用工具

连接后，你的助手可以使用以下工具。读取工具只查看你的数据；写入工具会更改预算（标记为删除的工具会移除数据）。

预算与设置

工具	功能	访问权限
ynab_list_budgets	列出你的 YNAB 预算	读取
ynab_budget_summary	汇总当月类别、余额和账户	读取
ynab_set_default_budget	记住默认预算，这样你就不必每次都指定	设置

类别与目标

工具	功能	访问权限
ynab_list_categories	列出类别组和类别，以及余额和目标	读取
ynab_create_category	在某个组中创建类别	写入
ynab_update_category	重命名类别、编辑其备注，或将其移至其他组	写入
ynab_create_category_group	创建类别组	写入
ynab_update_category_group	重命名类别组	写入
ynab_set_category_goals	创建、更新或移除类别目标	写入

交易

工具	功能	访问权限
ynab_list_transactions	按账户、类别、收款方或日期列出并筛选交易	读取
ynab_get_unapproved_transactions	列出等待批准的交易	读取
ynab_create_transaction	添加交易	写入
ynab_update_transaction	编辑现有交易	写入
ynab_approve_transaction	批准一笔待处理交易	写入
ynab_bulk_approve_transactions	一次性批准多笔待处理交易	写入
ynab_delete_transaction	删除交易	写入（删除）

计划交易（定期）

工具	功能	访问权限
ynab_list_scheduled_transactions	列出计划交易／定期交易	读取
ynab_create_scheduled_transaction	安排未来交易或定期交易	写入
ynab_update_scheduled_transaction	编辑计划交易	写入
ynab_delete_scheduled_transaction	删除计划交易	写入（删除）

预算工作流

工具	功能	访问权限
ynab_move_funds_between_categories	在类别之间转移已编列预算的资金	写入
ynab_auto_distribute_funds	按目标将“待分配”资金分配到各类别	写入
ynab_handle_overspending	通过转移资金弥补超支类别	写入
ynab_budget_from_history	根据历史支出进行分配	写入
ynab_reconcile_account	将账户与对账单余额进行对账	写入

分析与洞察（只读）

工具	功能
ynab_analyze_spending_patterns	发现支出趋势和异常
ynab_goal_progress_report	跟踪类别目标的完成进度
ynab_cash_flow_forecast	根据历史记录预测近期现金流
ynab_category_performance_review	按类别比较预算金额与实际金额
ynab_net_worth_analysis	汇总各账户的净资产

YNAB API 覆盖范围

这些工具与官方 YNAB API（通过 ynab JavaScript SDK 访问）的对应关系。✅ = 已覆盖，◐ = 部分覆盖，— = 尚未覆盖。

YNAB API 范围	覆盖情况	工具 / 备注
预算（计划）	✅	ynab_list_budgets、ynab_budget_summary；不提供计划设置
账户	◐	通过 ynab_budget_summary、ynab_net_worth_analysis、ynab_reconcile_account 读取余额；不支持创建账户或单独列出账户
类别与分组	✅	列出、创建和更新类别与分组；目标；按月分配资金
月份	✅	通过 ynab_budget_summary 和分析工具提供
交易	✅	列出、创建、更新、删除、批准和批量批准交易（不提供文件 import）
计划交易	✅	列出、创建、更新、删除
收款方	—	交易工具中按名称隐式引用；不提供列出或更新收款方的工具
收款方位置	—	不提供
用户	—	身份验证由 OAuth 处理；不提供 getUser

除了原始 API 外，此服务还提供了组合工具，这些工具没有对应的单一 API 端点：预算工作流（转移资金、自动分配、处理超支、根据历史记录编列预算、对账）和分析工具（支出模式、目标进度、现金流、类别表现、净资产）。

故障排除

ChatGPT 中未显示连接器

• 确认你的套餐支持自定义 MCP 连接器。
• 确认已启用开发者模式。
• 如果你使用的是工作区套餐，请确认管理员已启用所需设置。

Claude 中未显示连接器

• 确认你的套餐支持远程 MCP 连接器。
• 对于 Team 或 Enterprise，请确认工作区所有者已先添加连接器。

已连接，但 YNAB 工具无法使用

• 断开连接器，然后重新连接。
• 确保已完成 YNAB OAuth 授权步骤。
• 开始新的聊天，并为该对话重新启用连接器。

MCP URL 无法使用

• 确保粘贴的是完整的 HTTPS URL。
• 如果托管 URL 中包含结尾的 /mcp，请勿将其删除。

隐私

此服务使用 OAuth 连接到你的 YNAB 账户，不会直接索要你的 YNAB 密码。

YNAB 不以任何方式为此应用提供官方支持。使用风险由你自行承担。

请在此处阅读隐私政策：

• PRIVACY.md

自托管或运营者须知

如果你想自行部署或托管此服务，请参阅 CONTRIBUTING.md。 本 README 特意面向通过 ChatGPT 或 Claude 连接托管服务的最终用户编写。