Spendlog

Track expenses, income, budgets, and invoices directly in Claude with PDF export and tax reports.

GitHub

Spendlog

Expense tracking for freelancers, inside Claude. No apps. No spreadsheets.

Track expenses, send invoices, manage budgets — all in natural language. Your data stays local in SQLite.

npm version npm downloads CI 43 MCP tools 382 tests MIT License

Spendlog monthly summary in Claude

Works with

Claude Desktop | Claude Code | VS Code | Cursor

Quick Start

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 — track expenses while you work, right where you already are
  • Local-first — all data in ~/.spendlog/spendlog.db, no account needed
  • Natural language — no forms, no menus, just tell Claude what you spent
  • 43 tools — invoicing, budgets, recurring expenses, tax 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 € — PDF saved

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

43 tools across 11 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
Connectionconnect connection_status disconnect
Syncsync_status sync_now
Settingsget_profile set_profile get_notifications

Configuration

Manual setup (if the installer didn't work)

Claude Desktop — edit your config file:

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

Claude Code:

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. Cloud sync via spendlog.dev is opt-in.

Note: Spendlog is a tracker, not accounting software. Use it for personal insights, not official bookkeeping.

Development

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

git clone https://github.com/makz81/spendlog.git
cd spendlog
npm install
npm run dev       # MCP server with watch mode
npm run test      # 382 tests
npm run typecheck # type check (no emit)

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

License

MIT

Servidores relacionados