remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows configuration of the YNAB API key through a .env file in the project root
Uses Taskfile for project management with commands like 'task dev', 'task test', etc.

MCP YNAB サーバー

モデルコンテキストプロトコルを通じて YNAB (You Need A Budget) 機能へのアクセスを提供する MCP サーバー実装。

特徴

口座残高と取引を表示する
新しい取引を作成する
標準化された MCP リソースを通じて YNAB データにアクセスする

インストール

uv pip install -e .

構成

サーバーが機能するにはYNAB APIキーが必要です。YNAB開発者設定から取得できます。

API キーは次の方法で提供できます。

環境変数: YNAB_API_KEY=your_api_key
MCP秘密管理システム
プロジェクトルートの.envファイル

使用法

サーバーの実行

# Development mode with hot reload and browser launch
task dev

# Production install for Claude Desktop, Goose, or any other MCP-supported environment
task install

利用可能なリソース

ynab://accounts - すべての YNAB アカウントをリストします
ynab://transactions/{account_id} - 特定のアカウントの最近の取引を取得する

利用可能なツール

create_transaction - 新しいトランザクションを作成する
get_account_balance - アカウントの現在の残高を取得する

使用例

# Create a new transaction
result = await create_transaction(
    account_id="your_account_id",
    amount=42.50,  # in dollars
    payee_name="Coffee Shop",
    category_name="Dining Out",
    memo="Morning coffee"
)

# Get account balance
balance = await get_account_balance("your_account_id")

# List accounts
accounts = await ctx.read_resource("ynab://accounts")

# Get recent transactions
transactions = await ctx.read_resource(f"ynab://transactions/{account_id}")

発達

# Install dependencies (uses uv)
task deps

# Run all tests including integration tests (you will need a YNAB API key for this)
task test:all

# Generate coverage report
task coverage

# Format and lint code
task fmt  # Should add this to Taskfile

プロジェクトタスク

このプロジェクトでは、一般的な操作にタスクファイルを使用します。主なコマンドは次のとおりです。

task dev       # Start dev server with auto-reload
task test      # Run unit tests
task coverage  # Generate test coverage report
task install   # Install production build
task deps      # Synchronize dependencies

利用可能なすべてのタスクについては、 Taskfile.yml を参照してください。

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

View all tools

ユーザーが YNAB データと対話し、アカウント残高、取引にアクセスしたり、モデルコンテキストプロトコルを通じて新しい取引を作成したりできるようにする MCP サーバー。

Related Resources

Reddit Discussion about this server

MCP YNAB Server