Ynab Mcpb

MCP运维云端

提供方 mbmccormick

运维云端 未标注 Token 官方维护 Claude DesktopClaude

一个非官方的Claude桌面扩展,通过与You Need A Budget(YNAB)API的无缝集成,直接在Claude对话中管理完整的预算工作流程。

一句话选型结论

按资料字段整理

Ynab Mcpb 属于运维云端类 MCP 服务器,传输方式未标注,Token,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 7 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 官方维护 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

预算管理JavaScript本地部署财务管理Claude扩展YNAB集成桌面应用

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Ynab Mcpb当前 未标注 未标注 未标注 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方mbmccormick上游标注的维护方 mbmccormick
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方官方维护核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.8 KB
来自项目仓库与上游目录的原文,未做删改

You Need A Budget (Unofficial) - Claude Desktop Extension

A comprehensive Claude Desktop Extension that provides seamless integration with You Need A Budget, enabling you to manage your complete budgeting workflow directly from Claude conversations using the YNAB API.

> Note: This is an unofficial extension and is not affiliated with or endorsed by You Need A Budget.

Quick Start

Installation

  1. Get YNAB API Token from YNAB Developer Settings
    - Click "New Token"
    - Give it a name (e.g., "Claude Desktop")
    - Copy the generated token

  2. Download the ynab-mcpb.mcpb file from the latest release

  3. Install in Claude Desktop (Settings → Extensions → Install Extension)
    - Select the downloaded .mcpb file
    - When prompted, paste your YNAB API Token

  4. Start using YNAB tools in your conversations!

> 💡 Pro Tip: Use 'last-used' as the budget_id to access your most recently used budget.

Features

🎯 Core Functionality

  • Complete Budget Management: View and manage all your budgets
  • Account Operations: Access all accounts, create new ones, and view balances
  • Category Management: View categories, set budgeted amounts, and track spending
  • Transaction Management: Create, read, update, and delete transactions
  • Advanced Filtering: Filter transactions by account, category, payee, or date range

🔍 Discovery & Navigation

  • Payee Management: View all payees and their transaction history
  • Scheduled Transactions: Access and review recurring transactions
  • Monthly Budgets: View budget snapshots for any month
  • Multi-Budget Support: Work with multiple budgets seamlessly

🛠️ Advanced Features

  • Flexible Updates: Modify transactions and category budgets with full parameter control
  • Data Integrity: Comprehensive input validation and error handling
  • Security: Secure API token authentication
  • Cross-Platform: Works on macOS, Linux, and Windows

API Reference

📊 Budgets

get_budgets - Get all budgets

Parameters: None

get_budget - Get budget details

Required: budget_id (use 'last-used' for most recent)

get_budget_settings - Get budget settings

Required: budget_id

💰 Accounts

get_accounts - Get all accounts

Required: budget_id

get_account - Get specific account

Required: budget_id, account_id

create_account - Create new account

Required: budget_id, name, type, balance
Types: checking, savings, creditCard, cash, lineOfCredit, otherAsset, otherLiability, mortgage, autoLoan, studentLoan, personalLoan, medicalDebt, otherDebt

📁 Categories

get_categories - Get all categories

Required: budget_id

get_category - Get specific category

Required: budget_id, category_id

get_category_for_month - Get category for specific month

Required: budget_id, month (YYYY-MM-DD), category_id

update_category_for_month - Update category budget

Required: budget_id, month (YYYY-MM-DD), category_id, budgeted (in milliunits)

💳 Transactions

> Note: For the transaction listing tools below, if since_date is omitted the YNAB API returns only the last year of transactions. Provide an explicit since_date to retrieve older transaction history.

get_transactions - Get transactions for a budget

Required: budget_id
Optional: since_date (YYYY-MM-DD), type (uncategorized, unapproved)

get_transaction - Get specific transaction

Required: budget_id, transaction_id

get_transactions_by_account - Get transactions for account

Required: budget_id, account_id
Optional: since_date

get_transactions_by_category - Get transactions for category

Required: budget_id, category_id
Optional: since_date

get_transactions_by_payee - Get transactions for payee

Required: budget_id, payee_id
Optional: since_date

create_transaction - Create new transaction

Required: budget_id, account_id, date (YYYY-MM-DD), amount (in milliunits)
Optional: payee_id, payee_name, category_id, memo, cleared, approved, flag_color

update_transaction - Update transaction

Required: budget_id, transaction_id
Optional: account_id, date, amount, payee_id, category_id, memo, cleared, approved, flag_color

delete_transaction - Delete transaction

Required: budget_id, transaction_id

🔄 Scheduled Transactions

get_scheduled_transactions - Get all scheduled transactions

Required: budget_id

get_scheduled_transaction - Get specific scheduled transaction

Required: budget_id, scheduled_transaction_id

👥 Payees

get_payees - Get all payees

Required: budget_id

get_payee - Get specific payee

Required: budget_id, payee_id

📅 Months

get_months - Get all months

Required: budget_id

get_month - Get specific month

Required: budget_id, month (YYYY-MM-DD or 'current')

Usage Examples

Budget Overview```

Show me an overview of my current budget, including all categories and how much I've budgeted vs. spent


### Transaction Management```
Create a transaction for $45.32 at Whole Foods in my checking account, categorized as Groceries, dated today

Spending Analysis```

Show me all my dining out transactions from the past 30 days and calculate how much I've spent


### Category Management```
Set my Groceries category budget to $500 for this month

Account Balances```

What are the balances of all my accounts?


### Monthly Review```
Show me my budget for this month and highlight any categories where I'm overspending

Important Concepts

Milliunits

YNAB API uses "milliunits" for all currency amounts:
- 1000 milliunits = $1.00
- Example: $45.32 = 45,320 milliunits
- Inflow (income) = positive values
- Outflow (expenses) = negative values

Budget ID

  • Use 'last-used' to automatically use your most recently accessed budget
  • Or provide the specific budget ID from get_budgets

Date Format

  • All dates use ISO format: YYYY-MM-DD
  • Example: '2025-01-15' for January 15, 2025
  • For months: Use the first day of the month (e.g., '2025-01-01' for January 2025)

Transaction Status

  • cleared: cleared, uncleared, reconciled
  • approved: true or false (default: false for new transactions)
  • flag_color: red, orange, yellow, green, blue, purple, or null

Requirements

  • Node.js: Version 18.0.0 or higher
  • YNAB Account: Active YNAB subscription
  • YNAB API Token: Personal Access Token from YNAB Developer Settings
  • Claude Desktop: Compatible with MCPB specification
  • Internet Connection: Required for API access

Development

Building from Source```bash

Clone the repository

git clone https://github.com/mbmccormick/ynab-mcpb.git
cd ynab-mcpb

Install dependencies

npm install

Validate the code

npm run validate

Package the extension

npm run package


This will create `ynab-mcpb.mcpb` which you can install in Claude Desktop.

### Running Tests```bash
# Set your API token for testing
export YNAB_API_TOKEN="your-personal-access-token"

# Run validation tests
node test/test-validation.js

# Run error handling tests
node test/test-error-handling.js

Getting Your API Token

  1. Visit YNAB Developer Settings
  2. Click "New Token"
  3. Give it a name (e.g., "Claude Desktop")
  4. Copy the generated token
  5. Use it during installation or for testing

Architecture

Project Structure```

ynab-mcpb/
├── manifest.json # MCPB extension manifest
├── package.json # Dependencies and scripts
├── README.md # Documentation
├── .mcp.json # MCP configuration
├── .gitignore # Git ignore rules
└── server/
├── index.js # Main MCP server
├── tool-definitions.js # MCP tool schemas
├── ynab-client.js # YNAB API client
├── server-config.js # Configuration constants
└── utils.js # Utilities and helpers


### Key Design Principles
- **Separation of Concerns**: Modular architecture with clear responsibilities
- **Security First**: Secure API token handling and HTTPS communication
- **User-Friendly**: Intuitive parameter names and helpful error messages
- **Robust Error Handling**: Comprehensive error catching and reporting
- **Cross-Platform**: Works on all major operating systems
- **Extensible**: Easy to add new tools and functionality
- **Modern JavaScript**: ES6 modules with async/await

## Security Features

- **API Token Security**: Token stored in environment variables, never in code
- **HTTPS Communication**: All API requests use secure HTTPS
- **Input Validation**: All parameters validated for type and format
- **Error Handling**: Structured error responses with detailed logging
- **Timeout Management**: Prevents hanging API requests (30s default)
- **Rate Limiting**: Respects YNAB API rate limits (200 requests/hour)

## Development

### Running in Development Mode```bash
# Enable debug logging
DEBUG=true npm start

# Or use the dev script
npm run dev

Validating Code```bash

npm run validate


### Testing the Extension```bash
# Start the server
npm start

# The server will listen on stdio for MCP requests

Troubleshooting

Common Issues

API Token Not Set```
Error: YNAB_API_TOKEN environment variable is required
Solution: Set the YNAB_API_TOKEN environment variable or add it to .mcp.json


**Invalid API Token**```
Error: YNAB API error (401): Unauthorized
Solution: Verify your API token is correct at https://app.ynab.com/settings/developer

Rate Limit Exceeded```
Error: YNAB API error (429): Too Many Requests
Solution: Wait a few minutes. YNAB allows 200 requests per hour per token.


**Network Errors**```
Error: YNAB API request failed
Solution: Check your internet connection and verify YNAB service status

Debug Information```bash

Enable detailed logging

DEBUG=true npm start
```

Getting Help

  • YNAB API Issues: Check YNAB API Documentation
  • Claude Desktop: Follow Claude Desktop documentation
  • Extension Issues: Create issue in project repository

API Rate Limits

  • Limit: 200 requests per hour per access token
  • Recommendation: Use delta requests when possible to reduce API calls
  • Best Practice: Cache frequently accessed data

License

MIT License - See package.json for details

Acknowledgments

  • YNAB for their excellent API and budgeting platform
  • Anthropic for the Model Context Protocol (MCP) SDK
  • Community for feedback and contributions

Built with ❤️ for the Claude Desktop ecosystem

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Ynab Mcpb 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Ynab Mcpb 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Ynab Mcpb 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Ynab Mcpb 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Ynab Mcpb 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Ynab Mcpb 能提供哪些能力?

资料显示能力标签包括 财务管理、JavaScript、Claude、桌面应用。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。