Whooing MCP
whooing-mcp
Whooing (후잉) 개인 자산 관리를 위한 MCP 서버 — 거래 내역 관리, 지출 확인, 대차대조표, 예산 등을 지원합니다.
설정
1. API 자격 증명 가져오기
후잉 앱 설정으로 이동합니다.
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환경 변수를 기본값으로 사용합니다.쓰기 도구는 계정 캐시에서 계정 유형을 자동으로 확인합니다. 계정 ID를 먼저 조회하려면
whooing_accounts를 사용하세요.
데몬으로 실행 (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.
Maintenance
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 gradedqualityCmaintenanceProvides 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