Spendlog

io.github.makz81由 GitHub 帳號 makz81 發布v1.0.4更新於 Oct 24, 2026

MCP server for expense tracking, invoices, budgets, and financial insights directly in Claude

已驗證STDIO僅桌面效率與工作流金融

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理用自然語言在本機 SQLite 檔案中記錄事業支出、收入、預算與發票。

可以做什麼
  • 記錄與修改支出和收入、列出交易並刪除項目
  • 彙總支出、依類別拆分、比較不同期間並產生稅務彙總
  • 建立、列出、複製發票，標記為已寄出或已付款，以及刪除發票
  • 設定與更新預算，並查看預算狀態
  • 管理週期性支出、專案與類別
  • 匯出交易與發票（含供稅務顧問使用的匯出），並讀取或設定個人資料
適用情境
適合個人創業者與自由工作者在 Claude Code 或 Claude Desktop 中隨手記錄成本、追蹤預算和草擬發票，不必另外安裝記帳軟體或試算表。
執行需求
透過 npx spendlog 在本機執行，需要 Node.js 20 以上版本。不需帳號或 API 金鑰。可選環境變數用來設定語言、資料目錄、SQLite 資料庫路徑與預設專案。
安裝前請注意
助理可以建立、修改和刪除交易、發票、預算、專案與類別，誤操作或刪除會影響你的紀錄。匯出會在磁碟寫入 CSV 檔案。它是成本記錄工具而非會計軟體，不應用於正式記帳或報稅。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Spendlog，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Spendlog

Cost & expense tracking for solo entrepreneurs, right inside Claude Code. No apps. No spreadsheets. No account.

Track what your business spends, manage budgets, write invoices — all in natural language. Your data stays 100% local in SQLite. Nothing leaves your machine.

[npm version] [npm downloads] [CI] [38 MCP tools] [382 tests] [MIT License]

[Spendlog monthly summary in Claude]

Works with

Claude Code | Claude Desktop | VS Code | Cursor

Quick Start

bash
npx spendlog

Or one-click install:

[Install in VS Code] [Install in Cursor]

The installer auto-configures Claude Desktop and Claude Code. Restart Claude, then try:

"Track 50€ for hosting"

That's it. Requires Node.js 20+.

Why Spendlog?

  • Zero context-switching — log costs while you build, right where you already work
  • Local-first — all data in ~/.spendlog/spendlog.db, no account, no cloud
  • Natural language — no forms, no menus, just tell Claude what you spent
  • 38 tools — invoicing, budgets, recurring expenses, CSV export, multi-project tracking
  • Multilingual — English and German (EN/DE), with i18n ready for more

Examples

Tracking:

You: "29€ for ChatGPT subscription"Claude: Expense saved: 29.00 € — Category: IT & Software
You: "Export 2025 for my accountant"Claude: 247 transactions written to ~/spendlog-export-2025.csv

Invoices:

You: "Create invoice for TechCorp, web development, 8h at 95€/h"Claude: Invoice #2026-004 created — 760.00 €
You: "Mark it as paid"Claude: Invoice #2026-004 marked as paid, income recorded.

Analysis:

You: "How much did I spend on software this quarter?"Claude: IT & Software: 287.00 € (12 transactions) — 23% of total expenses
You: "Compare January vs February"Claude: Expenses up 15%. Biggest increase: Marketing (+120€)

Tools

38 tools across 9 categories:

CategoryTools
Transactionsadd_expense add_income list_transactions update_transaction delete_transaction
Analysisget_summary get_category_breakdown compare_periods get_tax_summary
Invoicescreate_invoice list_invoices get_invoice mark_invoice_sent mark_invoice_paid delete_invoice duplicate_invoice
Budgetsset_budget get_budget_status list_budgets update_budget delete_budget
Recurringcreate_recurring list_recurring delete_recurring process_recurring
Projectscreate_project list_projects rename_project delete_project
Categorieslist_categories add_category delete_category
Exportexport_transactions export_invoices export_for_tax_advisor
Settingsget_profile set_profile get_notifications

Configuration

Manual setup (if the installer didn't work)

Claude Desktop — edit your config file:

json
{  "mcpServers": {    "spendlog": {      "command": "npx",      "args": ["-y", "--package=spendlog", "spendlog-mcp"]    }  }}

Claude Code:

bash
claude mcp add spendlog -- npx -y --package=spendlog spendlog-mcp

Environment variables

VariableDescriptionDefault
SPENDLOG_LANGUAGEen or deen
SPENDLOG_DATA_DIRData directory path~/.spendlog
DATABASE_PATHFull path to SQLite database$SPENDLOG_DATA_DIR/spendlog.db
SPENDLOG_PROJECTDefault project for all transactionsnone

Privacy

All data stays on your machine, in a local SQLite file. No account, no cloud, no telemetry — nothing is ever sent anywhere.

Note: Spendlog is a cost tracker, not accounting software. Use it for your own insights, not official bookkeeping or tax filing.

Development

TypeScript (strict), Vitest for tests, TypeORM + SQLite for storage.

bash
git clone https://github.com/makz81/spendlog.gitcd spendlognpm installnpm run dev       # MCP server with watch modenpm run test      # 382 testsnpm run typecheck # type check (no emit)

See CONTRIBUTING.md for architecture details and how to add new tools.

License

MIT

來源：README.md，提交 0e51678

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.4最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分