Skip to main content
Glama
Whooing MCP

Whooing MCP

by jmjeong

whooing-mcp

npm version

MCP-сервер для личных финансов Whooing (후잉) — управление транзакциями, просмотр расходов, бухгалтерских балансов, бюджетов и многого другого.

Настройка

1. Получение API-учетных данных

  1. Перейдите в Настройки приложения Whooing

  2. Запишите свои app_id, token и signature

  3. Найдите свой 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": "..."
      }
    }
  }
}

Инструменты

Инструмент

Описание

Параметры

whooing_pl

Прибыли и убытки (расходы/доходы по категориям)

start_date?, end_date?, section_id?

whooing_entries

Список транзакций с названиями счетов

start_date?, end_date?, limit?, section_id?

whooing_balance

Бухгалтерский баланс (активы, обязательства, капитал)

start_date?, end_date?, section_id?

whooing_accounts

Полный список счетов

section_id?

whooing_sections

Список всех разделов (가계부)

(нет)

whooing_calendar

Обзор ежедневных доходов/расходов по месяцам

start_month?, end_month?, section_id?

whooing_frequent_items

Сохраненные шаблоны частых транзакций

section_id?

whooing_latest_items

Недавние уникальные элементы для автозаполнения (60 дней)

section_id?

whooing_add_entry

Создание новой записи транзакции

entry_date, l_account_id, r_account_id, item, money, memo?, section_id?

whooing_update_entry

Обновление существующей записи

entry_id, entry_date, l_account_id, r_account_id, item, money, memo?, section_id?

whooing_delete_entry

Удаление записи

entry_id, section_id?

  • Даты используются в формате 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 tools
whooing_account_activityA
Read-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_accountsA
Read-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_balanceA
Read-only

Get balance sheet (assets, liabilities, capital) as of a date range

Inputs: start_date, end_date, section_id.

whooing_budgetB
Read-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_calendarA
Read-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_candidatesA
Read-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_entriesB
Read-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_detailA
Read-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_itemsB
Read-only

List frequently used transactions (templates for quick entry). Returns saved transaction templates organized by slots.

Inputs: section_id.

whooing_latest_itemsA
Read-only

Get recent unique transaction items from the past 60 days. Useful for autocomplete suggestions when adding new entries.

Inputs: section_id.

whooing_monthly_summaryA
Read-only

Get month-by-month income, expense, net amount, and transaction count for a month range.

Inputs: start_month, end_month, section_id.

whooing_plA
Read-only

Get profit & loss summary (spending and income by category) for a date range

Inputs: start_date, end_date, section_id.

whooing_search_entriesA
Read-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_sectionsA
Read-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

    A4/5.0

    Scored across 18 tools

    Disambiguation5/5

    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'.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides read-only access to Monarch Money financial data, enabling AI assistants to analyze transactions, budgets, and cashflow.
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides read-only access to Trading 212 accounts, enabling AI assistants to retrieve portfolio positions, account summaries, instrument data, and transaction history.
      32 npm
      5
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides read-only access to Kledo accounting data, enabling listing and searching of invoices, contacts, products, and running financial reports through natural language.
      20 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides 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