Organizze

Organizze MCP

Claude を Organizze の個人向け金融 API に接続する MCP（Model Context Protocol）サーバーです。Claude に自然な言葉で家計について質問すると、適切なデータを自動的に取得します。

インストール

サーバーを Claude の MCP 設定に追加します。

{
  "mcpServers": {
    "organizze-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "organizze-mcp",
        "--organizze-username=YOUR_USERNAME",
        "--organizze-api-key=YOUR_API_KEY"
      ]
    }
  }
}

• YOUR_USERNAME — Organizze へのログインに使用するメールアドレス
• YOUR_API_KEY — Organizze のアカウント設定で確認できます

利用可能なツール

口座

ツール	説明
get-bank-accounts	すべての銀行口座を一覧表示するか、ID で 1 つ取得します

取引

ツール	説明
get-transactions	期間を指定して取引を一覧表示します。口座または定期取引のステータスで絞り込むこともできます。デフォルトは当月です
get-transaction	ID を指定して、単一の取引の詳細をすべて取得します
create-transaction	単発の支出または収入の取引を作成します

振替

ツール	説明
get-transfers	期間を指定して銀行口座間の振替を一覧表示します。デフォルトは当月です
get-transfer	ID を指定して、単一の振替の詳細をすべて取得します

クレジットカード

ツール	説明
get-credit-cards	すべてのクレジットカードを一覧表示するか、ID で 1 つ取得します
get-credit-cards-invoices	クレジットカードの請求書を一覧表示します。デフォルトは当年です
get-credit-cards-invoice-details	明細項目の取引と支払い状況を含む、請求書の詳細をすべて取得します

予算とカテゴリー

ツール	説明
get-budgets	カテゴリーごとの月間または年間の予算目標を取得します
get-categories	すべてのカテゴリーを一覧表示するか、ID で 1 つ取得します
get-spending-summary	合計、割合、任意の予算との比較を含め、カテゴリー別に集計した支出を取得します

プロンプトの例

What did I spend last month?

Show me all transactions from my Nubank account in March.

How close am I to my grocery budget this month?

List my credit card invoices for 2025.

I spent R$45 on lunch today — add it to my Food category.

How much did I transfer between accounts this year?

開発

npm install
npm run build   # compile TypeScript
npm test        # run the test suite
npm run test:watch  # watch mode

CI ワークフローにより、プルリクエストごとにビルドとテストが自動的に実行されます。

ライセンス

MIT