calebl/ynab-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

161 stars 70 forks 品質 85 トレンド 37MIT

Repository Install

calebl/ynab-mcp-server は、https://github.com/calebl/ynab-mcp-server. からインポートされたMCPサーバー候補です。

概要

calebl/ynab-mcp-server は、https://github.com/calebl/ynab-mcp-server. からインポートされたMCPサーバー候補です。

概要（AI 翻訳）

YNABプランとやり取りするためのモデルコンテキストプロトコル(MCP)サーバーです。

AIがこのツールとやり取りするには、パーソナルアクセストークンを取得する必要があります YNABより: https://api.ynab.com/#personal-access-tokens. このMCPサーバーを任意のクライアントはYNAB_API_TOKENとして個人のアクセストークンを提出する必要があります。*このトークンは決してLLMに直接送られません。 は環境変数にプライベートに保存されます。 YNAB APIでの使用。

AIがアシスタントがYNABプランを読み、修正します。

サーバーは公式のYNAB APIと通信しています ynabSDK。あなたのパーソナルアクセストークン環境変数に存在し、モデルに送られることはありません。

1つのコードベースから2つの方法で動作します:

ローカル(stdio) — Claude CodeまたはClaude Desktopの子プロセス自分のマシン。一番シンプルですが、そのマシンが稼働している間だけ動作します。
リモート(Cloudflare Worker) — GitHubサインインの背後にデプロイされ、 claude.ai カスタムコネクタなので、ウェブとモバイルアプリの両方から動作しますパソコンの電源を切ったまま。見て DEPLOY.md。

両方のエントリーポイントは、共有ツールを’src/registryから登録します。

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

ynab-mcp-server

A Model Context Protocol (MCP) server for interacting with your YNAB plans at https://ynab.com

In order to have an AI interact with this tool, you will need to get your Personal Access Token from YNAB: https://api.ynab.com/#personal-access-tokens. When adding this MCP server to any client, you will need to provide your personal access token as YNAB_API_TOKEN. This token is never directly sent to the LLM. It is stored privately in an environment variable for use with the YNAB api.

A Model Context Protocol server that lets an AI assistant read and modify a YNAB plan.

The server talks to the YNAB API through the official ynab SDK. Your Personal Access Token lives in an environment variable and is never sent to the model.

It runs two ways from one codebase:

Local (stdio) — a child process of Claude Code or Claude Desktop on your own machine. Simplest, but only works on that machine while it is running.
Remote (Cloudflare Worker) — deployed behind GitHub sign-in and added to claude.ai as a custom connector, so it works from the web and the mobile app with your computer switched off. See DEPLOY.md.

Both entry points register the shared tools from src/registry.ts. The Worker can also run an optional scheduled auto-budget service that records what it would categorize, approve and assign without changing your plan and delivers spending alerts; see Auto-budget service.

Other providers:

Setup

Get a Personal Access Token from , then:

npm install
npm run build

Environment variables:

Variable	Required	Purpose
`YNAB_API_TOKEN`	yes	Personal Access Token used for every API call
`YNAB_PLAN_ID`	no	Default plan, so tools can omit `planId`. Find it with `ynab_list_plans`.
`TYPESAFE_API_KEY`	no	Operator-owned TypeSafe credential. Required, but not sufficient, to enable category suggestions.
`YNAB_AI_CATEGORIZATION`	no	Set to `"true"` together with `TYPESAFE_API_KEY` to expose the opt-in suggestion tool.
`YNAB_AI_TYPICAL_PAYEES`	no	Set to `"true"` to send each category’s most frequent payee names from the last 12 months with each model request. Off by default because it discloses aggregated payee history to TypeSafe.
`YNAB_READ_ONLY`	no	Set to `"true"` (case-insensitive; surrounding whitespace is ignored) to remove tools that write to YNAB, in both the stdio server and the Worker.

GitHub で README 全文を見る

インストール

npx wrangler login`, then create the `OAUTH_KV` namespace

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "ynab": {
      "command": "node",
      "args": ["/absolute/path/to/ynab-mcp-server/dist/index.js"],
      "env": {
        "YNAB_API_TOKEN": "your-token",
        "YNAB_PLAN_ID": "your-plan-id"
      }
    }
  }
}