Whooing MCP
whooing-mcp
Whooing (후잉) 個人財務用MCPサーバー — 取引の管理、支出、貸借対照表、予算などの確認が可能です。
セットアップ
1. API認証情報の取得
Whooingアプリ設定 にアクセスします
app_id、token、signatureを控えますAPIまたはURLから
section_idを確認します
2. 環境設定
export WHOOING_APP_ID=3
export WHOOING_TOKEN=your_token
export WHOOING_SIGNATURE=your_signature
export WHOOING_SECTION_ID=your_section_idまたは .env ファイルを作成します(.env.example を参照)。
Related MCP server: t212-mcp-server
使用方法
stdioモード (Claude Code, Claude Desktop)
npx whooing-mcpHTTPモード (デーモン)
npx whooing-mcp --http --port 8182Claude Code設定 (~/.mcp.json)
{
"mcpServers": {
"whooing": {
"command": "npx",
"args": ["whooing-mcp"],
"env": {
"WHOOING_APP_ID": "3",
"WHOOING_TOKEN": "...",
"WHOOING_SIGNATURE": "...",
"WHOOING_SECTION_ID": "..."
}
}
}
}Claude Desktop設定
{
"mcpServers": {
"whooing": {
"command": "npx",
"args": ["whooing-mcp"],
"env": {
"WHOOING_APP_ID": "3",
"WHOOING_TOKEN": "...",
"WHOOING_SIGNATURE": "...",
"WHOOING_SECTION_ID": "..."
}
}
}
}ツール
ツール | 説明 | パラメータ |
| 損益計算書(カテゴリ別の支出/収入) |
|
| 口座名を含む取引リスト |
|
| 貸借対照表(資産、負債、資本) |
|
| 全口座リスト |
|
| 全セクション(家計簿)リスト | (なし) |
| 月別の毎日の収入/支出概要 |
|
| 保存された頻出取引テンプレート |
|
| オートコンプリート用の最近のユニークな項目(60日間) |
|
| 新しい取引エントリの作成 |
|
| 既存エントリの更新 |
|
| エントリの削除 |
|
日付は
YYYYMMDD形式を使用します。デフォルト:当月(1日から今日まで)。カレンダーの月は
YYYYMM形式を使用します。デフォルト:当月。section_idは環境変数WHOOING_SECTION_IDがデフォルト値となります。書き込みツールは、口座キャッシュから口座タイプを自動的に解決します。先に
whooing_accountsを使用して口座IDを調べてください。
デーモンとしての実行 (macOS launchd)
~/Library/LaunchAgents/com.whooing.mcp.plist を作成します:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key><string>com.whooing.mcp</string>
<key>ProgramArguments</key>
<array>
<string>/opt/homebrew/bin/npx</string>
<string>whooing-mcp</string>
<string>--http</string>
<string>--port</string>
<string>8182</string>
</array>
<key>EnvironmentVariables</key>
<dict>
<key>WHOOING_APP_ID</key><string>3</string>
<key>WHOOING_TOKEN</key><string>YOUR_TOKEN</string>
<key>WHOOING_SIGNATURE</key><string>YOUR_SIGNATURE</string>
<key>WHOOING_SECTION_ID</key><string>YOUR_SECTION_ID</string>
<key>PATH</key><string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
</dict>
<key>KeepAlive</key><true/>
<key>RunAtLoad</key><true/>
<key>StandardOutPath</key><string>/tmp/whooing-mcp.log</string>
<key>StandardErrorPath</key><string>/tmp/whooing-mcp.err</string>
</dict>
</plist>chmod 600 ~/Library/LaunchAgents/com.whooing.mcp.plist
launchctl load ~/Library/LaunchAgents/com.whooing.mcp.plist開発
git clone https://github.com/jmjeong/whooing-mcp.git
cd whooing-mcp
npm install
npm run build
node dist/cli.jsライセンス
MIT
Available Tools
18 toolswhooing_account_activityARead-only
Summarize activity for one account in a date range, including totals, frequent items, and recent matching entries.
Inputs: start_date, end_date, section_id, account_id, +6 more.
whooing_accountsARead-only
Get the full list of accounts (assets, liabilities, income, expenses, capital)
Inputs: section_id.
whooing_add_entryA
Create a new transaction entry in Whooing (e.g. expense, income). Use whooing_accounts first to look up account IDs.
Inputs: entry_date (required), l_account_id (required), r_account_id (required), item (required), +3 more.
whooing_balanceARead-only
Get balance sheet (assets, liabilities, capital) as of a date range
Inputs: start_date, end_date, section_id.
whooing_budgetBRead-only
Get budget status (expenses) for a date range. Dates use YYYYMM (month) format.
Inputs: start_date, end_date, section_id.
whooing_bulk_add_entriesA
Create multiple transaction entries in Whooing. Use whooing_accounts first to look up account IDs.
Inputs: entries (required), section_id.
whooing_calendarARead-only
Get daily income/expense overview for a month. Shows per-day transaction counts, income, and expenses.
Inputs: start_month, end_month, section_id.
whooing_delete_entryA
Delete a transaction entry from Whooing. Use whooing_entries to find the entry_id first.
Inputs: entry_id (required), section_id.
whooing_duplicate_candidatesARead-only
Find likely duplicate transactions in a date range by grouping same date, amount, accounts, and item.
Inputs: start_date, end_date, section_id, limit, +19 more.
whooing_entriesBRead-only
Get transaction entries (individual transactions with account names) for a date range
Inputs: start_date, end_date, section_id, limit, +17 more.
whooing_entry_detailARead-only
Get one transaction entry by entry_id. Use this before updating or deleting when you already know the ID.
Inputs: entry_id (required), section_id.
whooing_frequent_itemsBRead-only
List frequently used transactions (templates for quick entry). Returns saved transaction templates organized by slots.
Inputs: section_id.
whooing_latest_itemsARead-only
Get recent unique transaction items from the past 60 days. Useful for autocomplete suggestions when adding new entries.
Inputs: section_id.
whooing_monthly_summaryARead-only
Get month-by-month income, expense, net amount, and transaction count for a month range.
Inputs: start_month, end_month, section_id.
whooing_plARead-only
Get profit & loss summary (spending and income by category) for a date range
Inputs: start_date, end_date, section_id.
whooing_search_entriesARead-only
Search transactions with query, account, amount, and date filters. Prefer this for natural-language find/search requests.
Inputs: start_date, end_date, section_id, limit, +17 more.
whooing_sectionsARead-only
List all sections (가계부) in the Whooing account
Inputs: no named parameters.
whooing_update_entryA
Update an existing transaction entry in Whooing. Use whooing_entries to find the entry_id, and whooing_accounts to look up account IDs.
Inputs: entry_id (required), entry_date (required), l_account_id (required), r_account_id (required), +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Each tool has a clear and distinct purpose, such as adding an entry vs. searching entries vs. getting accounts. There is minimal overlap, and descriptions help differentiate similar tools like 'entries' and 'search_entries'.
Most tools follow a consistent 'whooing_verb_noun' pattern (e.g., whooing_add_entry, whooing_delete_entry). However, a few tools like 'whooing_accounts' and 'whooing_budget' omit the verb, which is a minor inconsistency but still understandable.
With 18 tools, the server covers a comprehensive set of operations for personal finance management without being overwhelming. Each tool serves a necessary function, and the count is well-scoped for the domain.
The tool surface provides full lifecycle coverage: listing accounts, creating/reading/updating/deleting entries, balance sheets, profit/loss, budgets, calendar views, duplicate detection, and search. No obvious gaps exist for typical personal finance tracking.
Related MCP Connectors
Ask your AI about your own accounts, debts, budgets and goals. OAuth sign-in, read-only by default.
Ask about your Waypoint Budget spending, budgets, goals and accounts. Read-only.
AI accounting: ask about your live AccountsOS books in plain English. Read-only tools for transactions, cash balances, invoices, bills, VAT, filing deadlines and reports across 32 countries. OAuth sign-in; free 14-day trial at accounts-os.com.
Read Ambrook books: P&L, balance sheets, unpaid invoices, bills due, and transactions. Read-only.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides read-only access to Monarch Money financial data, enabling AI assistants to analyze transactions, budgets, and cashflow.4MIT
- AlicenseNot gradedqualityDmaintenanceProvides read-only access to Trading 212 accounts, enabling AI assistants to retrieve portfolio positions, account summaries, instrument data, and transaction history.32 npm5MIT
- AlicenseAqualityBmaintenanceProvides read-only access to Kledo accounting data, enabling listing and searching of invoices, contacts, products, and running financial reports through natural language.3201 npmApache 2.0
- AlicenseNot gradedqualityCmaintenanceProvides read-only access to self-hosted cash-flow forecasts, balances, transactions, and credit-card data, letting AI clients answer spending and upcoming-obligation questions without modifying financial settings.MIT