English Français العربية

Spendlog

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package spendlog
Claude Code 
claude mcp add spendlog -- npx -y spendlog@1.0.4
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "spendlog": {
            "command": "npx",
            "args": [
                "-y",
                "spendlog@1.0.4"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Spendlog
  2. Why Spendlog?
  3. Examples
  4. Tools
  5. Configuration
  6. Privacy
  7. Development
  8. License

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.

Works with

Claude Code | Claude Desktop | VS Code | Cursor

Quick Start
npx spendlog

Or one-click install:

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:

{
  "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, 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.

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

الأسئلة الشائعة

ما هو Spendlog؟

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

كيف أثبّت Spendlog؟

يعمل على جهازك. في Claude Code: claude mcp add spendlog -- npx -y spendlog@1.0.4. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Spendlog إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Spendlog مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Spendlog؟

ينشره makz81. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.