Skip to main content
Glama
deenesjakoruzh
justmytwospence

ynab-mcp

by justmytwospence
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

ynab-mcp

YNAB APIの全機能を提供するMCP（Model Context Protocol）サーバーです。LLMが自然言語を通じて予算を読み取り、管理できるようにします。CRUD操作のためのツール、予算のコンテキストを把握するためのリソース、そしてガイド付きの財務ワークフローのためのプロンプトを提供します。

要件

Related MCP server: YNAB MCP Server

インストール

npm install -g ynab-mcp

またはソースからインストールする場合：

git clone https://github.com/justmytwospence/ynab-mcp.git
cd ynab-mcp
npm install
npm run build
npm install -g .

設定

YNAB APIトークンを環境変数として設定します：

export YNAB_API_TOKEN="your-token-here"

トークンは YNAB > Account Settings > Developer Settings で生成してください。

Claude Code

claude mcp add ynab-mcp ynab-mcp -e YNAB_API_TOKEN=your-token-here

Claude Desktop

claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "ynab-mcp",
      "env": {
        "YNAB_API_TOKEN": "your-token-here"
      }
    }
  }
}

ツール

YNAB APIの全機能を網羅する50のツール。すべての金額はYNABのミリユニット形式（例：$12.34 = 12340）を使用します。

レート制限への対応

YNAB APIの利用制限は、トークンごとに 1時間あたり200リクエスト（スライディングウィンドウ）です。サーバーはすべての呼び出しを追跡し、以下を提供します：

  • get_api_usage ツール / ynab://api-usage リソース — 明示的なオンデマンド確認（API呼び出しは0回）。

  • 自動警告：使用量が多くなると、すべてのツール結果に付加されます：

    • 残り50回以下で [RATE LIMIT WARNING]

    • 残り20回以下で [RATE LIMIT CRITICAL]

    • 残り0回で [RATE LIMIT REACHED]

各ツールの説明には、括弧内にAPI呼び出しコスト（例：[1 API call]）が含まれています。単一呼び出しツールのループよりも、一括ツール（create_transactions、update_transactions）の使用を推奨します。

ユーザー

ツール

説明

get_user

認証済みユーザー情報を取得

予算

ツール

説明

list_budgets

オプションの口座情報を含むすべての予算を一覧表示

get_budget

すべてのエンティティを含む予算の詳細を取得

get_budget_settings

日付と通貨形式の設定を取得

口座

ツール

説明

list_accounts

残高とタイプを含むすべての口座を一覧表示

get_account

単一の口座の詳細を取得

create_account

新しい口座を作成

カテゴリー

ツール

説明

list_categories

カテゴリーグループごとに分類されたすべてのカテゴリーを一覧表示

get_category

単一のカテゴリーの詳細を取得

create_category

新しいカテゴリーを作成

update_category

カテゴリーの名前、メモ、または目標を更新

get_month_category

特定の月のカテゴリー予算を取得

update_month_category

特定の月のカテゴリーの予算額を更新

create_category_group

新しいカテゴリーグループを作成

update_category_group

カテゴリーグループの名前を更新

取引

ツール

説明

list_transactions

オプションのフィルターを使用して取引を一覧表示

get_transaction

単一の取引の詳細を取得

create_transaction

新しい取引を作成

create_transactions

複数の取引を一括作成

update_transaction

既存の取引を更新

update_transactions

複数の取引を一括更新

delete_transaction

取引を削除

import_transactions

連携された金融機関からインポート

list_account_transactions

特定の口座の取引を一覧表示

list_category_transactions

特定のカテゴリーの取引を一覧表示

list_payee_transactions

特定の支払先の取引を一覧表示

list_month_transactions

特定の月の取引を一覧表示

予定取引

ツール

説明

list_scheduled_transactions

すべての予定/定期取引を一覧表示

get_scheduled_transaction

予定取引の詳細を取得

create_scheduled_transaction

新しい予定取引を作成

update_scheduled_transaction

予定取引を更新

delete_scheduled_transaction

予定取引を削除

支払先

ツール

説明

list_payees

すべての支払先を一覧表示

get_payee

単一の支払先の詳細を取得

update_payee

支払先の名前を更新

支払先ロケーション

ツール

説明

list_payee_locations

すべての支払先のGPSロケーションを一覧表示

get_payee_location

単一の支払先ロケーションを取得

get_payee_locations_for_payee

特定の支払先のすべてのロケーションを取得

月

ツール

説明

list_months

概要を含むすべての予算月を一覧表示

get_month

カテゴリー残高を含む詳細な月情報を取得

資金移動

ツール

説明

list_money_movements

すべての資金移動を一覧表示

get_month_money_movements

特定の月の資金移動を取得

list_money_movement_groups

すべての資金移動グループを一覧表示

get_month_money_movement_groups

特定の月の資金移動グループを取得

ワークフロー

ツール

説明

merge_category

ソースカテゴリーをターゲットに統合し、すべての取引と予算額を移動

delete_category

削除用にカテゴリーを整理：履歴をすべて置換先に再カテゴリー化し、予算をゼロにする（最終的な削除はYNABアプリ内で手動で行う必要があります — APIの制限）

audit_credit_card_payments

クレジットカードの支払いカテゴリー残高をカード残高と照合し、オプションで自動修正

リソース

リソースは、クライアントがツール呼び出しなしでコンテキストに取り込める構造化された予算データを提供します。テンプレートリソースはURIパラメーター（例：{budget_id}）を使用します。

リソース

URI

説明

APIコスト

API使用量

ynab://api-usage

現在のレート制限ステータス：使用済み呼び出し数、残り、ウィンドウリセット

0

予算概要

ynab://budgets/{budget_id}/summary

口座、残高、カテゴリーグループを含む予算の概要

1

口座一覧

ynab://budgets/{budget_id}/accounts

タイプ、残高、クリア済み/未クリア残高を含むすべての口座

1

月次カテゴリー

ynab://budgets/{budget_id}/months/{month}/categories

予算額、アクティビティ、残高を含む、ある月のすべてのカテゴリー

1

プロンプト

プロンプトは、ユーザーが一般的な予算管理タスクを実行するために呼び出せるガイド付きワークフローテンプレートです。LLMに対して、どのツールを呼び出し、結果をどのように解釈するかを指示します。

プロンプト

引数

説明

monthly-review

budget_id, month

予算月のレビュー：予算超過カテゴリー、支出の差異、資金不足の目標、CCの不一致

transaction-audit

budget_id, account_id, since_date

未分類、未承認、重複、異常な金額の取引を監査

budget-setup-guide

budget_id

ガイド付きウォークスルー：口座、カテゴリー、目標、予定取引、資金配分

spending-analysis

budget_id, month

カテゴリーの内訳、予算対実績、主要な支払先、収入対支出

credit-card-audit

budget_id, since_month?

CC支払いカテゴリー残高の監査（ドライラン実行後、適用前に確認するフロー）

開発

npm run dev    # Watch mode with tsx
npm run build  # Compile TypeScript
npm start      # Run compiled server

ライセンス

MIT

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • YNAB MCP Server

    ntdef
    A
    license
    Not graded
    quality
    C
    maintenance
    A Model Context Protocol server that enables interaction with You Need A Budget (YNAB) via their API, allowing users to manage budgets, accounts, categories, and transactions through natural language.
    2
    MIT

  • YNAB MCP Server

    chrisguidry
    F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that provides Large Language Models with access to YNAB (You Need A Budget) budgets, allowing them to fetch budget data including accounts, categories, and category groups.
    6

  • YNAB MCP Server

    WGDevelopment
    A
    license
    A
    quality
    D
    maintenance
    A minimal and auditable MCP server that enables local AI assistants to read and manage YNAB budget data. It supports operations like listing accounts, tracking transactions, and moving money between categories while maintaining user privacy.
    9
    MIT

  • YNAB MCP Server

    rgarcia
    A
    license
    B
    quality
    C
    maintenance
    Exposes YNAB API endpoints as MCP tools, allowing AI assistants to manage budgets, accounts, transactions, and more through natural language.
    44
    90
    MIT

View all related MCP servers

Related MCP Connectors

  • better-notion-mcp

    Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

  • ynab-mcp-server

    Hosted remote MCP server for YNAB on Cloudflare Workers with OAuth

  • Backtest360

    MCP server exposing the Backtest360 engine API as tools for AI agents.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/justmytwospence/ynab-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server