Skip to main content
Glama
Whooing MCP

Whooing MCP

by jmjeong

whooing-mcp

npm version

Servidor MCP para finanzas personales de Whooing (후잉): gestiona transacciones, visualiza gastos, balances generales, presupuestos y más.

Configuración

1. Obtener credenciales de API

  1. Ve a Configuración de la aplicación de Whooing

  2. Anota tu app_id, token y signature

  3. Encuentra tu section_id desde la API o la URL

2. Configurar el entorno

export WHOOING_APP_ID=3
export WHOOING_TOKEN=your_token
export WHOOING_SIGNATURE=your_signature
export WHOOING_SECTION_ID=your_section_id

O crea un archivo .env (consulta .env.example).

Related MCP server: t212-mcp-server

Uso

Modo stdio (Claude Code, Claude Desktop)

npx whooing-mcp

Modo HTTP (daemon)

npx whooing-mcp --http --port 8182

Configuración de Claude Code (~/.mcp.json)

{
  "mcpServers": {
    "whooing": {
      "command": "npx",
      "args": ["whooing-mcp"],
      "env": {
        "WHOOING_APP_ID": "3",
        "WHOOING_TOKEN": "...",
        "WHOOING_SIGNATURE": "...",
        "WHOOING_SECTION_ID": "..."
      }
    }
  }
}

Configuración de Claude Desktop

{
  "mcpServers": {
    "whooing": {
      "command": "npx",
      "args": ["whooing-mcp"],
      "env": {
        "WHOOING_APP_ID": "3",
        "WHOOING_TOKEN": "...",
        "WHOOING_SIGNATURE": "...",
        "WHOOING_SECTION_ID": "..."
      }
    }
  }
}

Herramientas

Herramienta

Descripción

Parámetros

whooing_pl

Pérdidas y ganancias (gastos/ingresos por categoría)

start_date?, end_date?, section_id?

whooing_entries

Lista de transacciones con nombres de cuenta

start_date?, end_date?, limit?, section_id?

whooing_balance

Balance general (activos, pasivos, capital)

start_date?, end_date?, section_id?

whooing_accounts

Lista completa de cuentas

section_id?

whooing_sections

Listar todas las secciones (가계부)

(ninguno)

whooing_calendar

Resumen diario de ingresos/gastos por mes

start_month?, end_month?, section_id?

whooing_frequent_items

Plantillas de transacciones frecuentes guardadas

section_id?

whooing_latest_items

Elementos únicos recientes para autocompletar (60 días)

section_id?

whooing_add_entry

Crear una nueva entrada de transacción

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

whooing_update_entry

Actualizar una entrada existente

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

whooing_delete_entry

Eliminar una entrada

entry_id, section_id?

  • Las fechas utilizan el formato YYYYMMDD. Predeterminado: mes actual (del día 1 hasta hoy).

  • Los meses del calendario utilizan el formato YYYYMM. Predeterminado: mes actual.

  • section_id utiliza por defecto la variable de entorno WHOOING_SECTION_ID.

  • Las herramientas de escritura resuelven los tipos de cuenta automáticamente desde la caché de cuentas. Utiliza whooing_accounts para buscar los IDs de cuenta primero.

Ejecución como daemon (macOS launchd)

Crea ~/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

Desarrollo

git clone https://github.com/jmjeong/whooing-mcp.git
cd whooing-mcp
npm install
npm run build
node dist/cli.js

Licencia

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