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 分