Whooing MCP
whooing-mcp
MCP-сервер для личных финансов Whooing (후잉) — управление транзакциями, просмотр расходов, бухгалтерских балансов, бюджетов и многого другого.
Настройка
1. Получение API-учетных данных
Перейдите в Настройки приложения Whooing
Запишите свои
app_id,tokenиsignatureНайдите свой
section_idв API или URL
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-mcpРежим HTTP (демон)
npx whooing-mcp --http --port 8182Конфигурация Claude 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.
Maintenance
Related MCP Connectors
Ask your AI about your own accounts, debts, budgets and goals. OAuth sign-in, read-only by default.
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-only personal finance for AI agents: budgets, receipts, net worth, bills. OAuth 2.1.
Read-only access to your own bank, card and brokerage accounts for Claude, ChatGPT and other AI agents: balances, transactions, spending, subscriptions, cashflow and investment holdings. It can never move money.
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
- AlicenseNot gradedqualityBmaintenanceProvides read-only access to Kledo accounting data, enabling listing and searching of invoices, contacts, products, and running financial reports through natural language.20 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