YNAB MCP Server

基本能力

产品定位

YNAB MCP Server 是一个个人财务管理工具，通过与 YNAB API 的交互，帮助用户管理预算、账户、类别和交易。

核心功能

• 获取预算、账户和类别信息
• 获取、创建和更新交易记录
• 创建新类别
• 更新类别的预算金额
• 获取预算摘要

适用场景

• 个人财务管理
• 预算跟踪和调整
• 交易记录管理
• 财务数据分析

工具列表

预算管理

• get_budgets: 获取认证用户的所有预算
• get_budget_summary: 获取预算摘要，可选择特定月份

账户管理

• get_accounts: 获取特定预算的所有账户

类别管理

• get_categories: 获取特定预算的所有类别
• create_category: 在指定的预算组中创建新类别
• update_category_budgeted: 更新特定月份中类别的预算金额

交易管理

• get_transactions: 获取特定预算的交易记录，可选择按日期、账户或类别过滤
• create_transaction: 在指定预算中创建新交易
• update_transaction: 更新特定交易的一个或多个字段

常见问题解答

• 如何获取 YNAB API 令牌？ 访问 YNAB 开发者设置 获取 API 令牌。

使用教程

使用依赖

• Python 3.13 或更高版本
• YNAB 账户和 API 令牌
• UV 包管理器（可选但推荐）

安装教程

1. 克隆仓库 bash git clone https://github.com/ntdef/ynab-mcp.git cd ynab-mcp

2. 创建虚拟环境 bash uv venv

3. 激活虚拟环境

4. Windows: venv\Scripts\activate

5. Unix/MacOS: source venv/bin/activate

6. 使用 UV 安装依赖 bash uv sync

7. 复制 .env.example 到 .env 并添加 YNAB API 令牌 bash cp .env.example .env # 使用编辑器编辑 .env 文件

调试方式

1. 运行服务器 bash uv run ynab-mcp

2. 运行测试 bash uv run pytest

3. 代码格式化 bash uv run isort src tests uv run black src tests

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。