OY

oliverames/ynab-mcp-server

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

41 stars 15 forks 质量 83 趋势 32MIT

本地 YNAB MCP 服务器,支持只读默认值,完整 API 覆盖,安全写入控制,并支持预算、交易、分类、账户和报告。

概览

将自然语言预算问题转化为安全的本地YNAB API工作流程 默认赋予你的AI助手只读预算权限,并明确写入选择 59个支持写入的工具 • 6个引导提示 • 撤销日志 • YNAB API v1.85 • 默认只读 快速入门 • 插件 • Claude 代码 • Codex • 其他主机 • 你可以做什么 • 工具参考 • 配置 通过 Claude Code、Codex、Hermes、Antigravity 或任何标准 MCP 主机运行 YNAB。对于需要远程 URL 的客户端,托管连接器 https://ynab.amesvt.com/mcp 通过 YNAB OAuth 登录每个用户,无需个人访问令牌复制到其他服务。两条路径都使用相同的速率感知工具层,使用美元而非毫单位,开始只读,日志写入以便可撤销。

概述(AI 翻译)

YNAB 的 MCP 服务器

将自然语言预算问题转化为安全的本地YNAB API工作流程 默认赋予你的AI助手只读预算权限,并明确选择写入

67个工具 + 4个发现助手 • 6个引导提示 • 撤销日志 • 默认支持45个只读操作 • 默认为只读

快速入门 • 插件 • 克劳德代码 • 编纂典籍 • 其他主持人 • 你可以做什么 • 工具参考 • 配置


通过Claude Code、Codex、Hermes、Antigravity或任何标准MCP主机运行YNAB。对于需要远程URL的客户端,托管连接器https://ames-ynab.link/mcp通过YNAB OAuth登录每个用户,无需个人访问令牌复制到其他服务。两条路径都使用相同的速率感知工具层,并将金额从美元与YNAB毫单位之间转换。直接注册开始时为只读,撤销日志记录支持的变更。部分操作仍需在YNAB中手动恢复。

为什么会有这样的存在

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

MCP Server for YNAB

Turn natural-language budget questions into safe, local YNAB API workflows Give your AI assistant read-only budget access by default, with explicit write opt-in

67 tools + 4 discovery helpers • 6 guided prompts • undo journal • 45 read-only operations by default • read-only by default

Quick Start • Plugin • Claude Code • Codex • Other Hosts • What You Can Do • Tools Reference • Configuration


Run YNAB through Claude Code, Codex, Hermes, Antigravity, or any stdio MCP host. For clients that need a remote URL, the hosted connector at https://ames-ynab.link/mcp signs each user in through YNAB OAuth, with no personal access token to copy into another service. Both paths use the same rate-aware tool layer and convert amounts between dollars and YNAB milliunits. Direct registration starts read-only, and the undo journal records supported changes. Some operations still require manual recovery in YNAB.

Why This Exists

YNAB’s budgeting philosophy works best when you interact with your budget frequently, but the app interface is not designed for quick questions or careful bulk cleanup. “How much did I spend on groceries this month?” should not require navigating three screens. “Categorize all my Amazon orders from this week” should not become a manual, one-by-one review.

This server gives your AI assistant a local interface to YNAB’s API, turning natural language into structured budget review and, when explicitly enabled, budget operations. It is designed for real budgeting work: finding overspending, reviewing unapproved transactions, checking category drift, investigating recurring payments, and making verified batch updates without giving the assistant broader access than it needs.

在 GitHub 查看完整 README

安装

npx -y @oliverames/mcp-server-for-ynab@latest
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "ynab": { "command": "npx", "args": ["-y", "@oliverames/mcp-server-for-ynab@latest"], "env": { "YNAB_OP_PATH": "op://Development/YNAB/credential" } } } }