Spendlog

Seguimiento de gastos, ingresos, presupuestos y facturas directamente en Claude con exportación a PDF e informes fiscales.

Documentación

Spendlog

Seguimiento de costos y gastos para emprendedores individuales, directamente dentro de Claude Code. Sin aplicaciones. Sin hojas de cálculo. Sin cuenta.

Registra lo que tu negocio gasta, gestiona presupuestos, redacta facturas — todo en lenguaje natural. Tus datos permanecen 100% locales en SQLite. Nada sale de tu máquina.

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

Spendlog monthly summary in Claude

Compatible con

Claude Code | Claude Desktop | VS Code | Cursor

Inicio rápido

npx spendlog

O instalación con un clic:

Install in VS Code Install in Cursor

El instalador configura automáticamente Claude Desktop y Claude Code. Reinicia Claude y luego prueba:

"Registra 50€ por hosting"

Eso es todo. Requiere Node.js 20+.

¿Por qué Spendlog?

  • Cero cambios de contexto — registra costos mientras construyes, justo donde ya trabajas
  • Primero local — todos los datos en ~/.spendlog/spendlog.db, sin cuenta, sin nube
  • Lenguaje natural — sin formularios, sin menús, solo dile a Claude cuánto gastaste
  • 38 herramientas — facturación, presupuestos, gastos recurrentes, exportación CSV, seguimiento multi-proyecto
  • Multilingüe — inglés y alemán (EN/DE), con i18n listo para más idiomas

Ejemplos

Seguimiento:

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

Facturas:

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.

Análisis:

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€)

Herramientas

38 herramientas en 9 categorías:

CategoríaHerramientas
Transaccionesadd_expense add_income list_transactions update_transaction delete_transaction
Análisisget_summary get_category_breakdown compare_periods get_tax_summary
Facturascreate_invoice list_invoices get_invoice mark_invoice_sent mark_invoice_paid delete_invoice duplicate_invoice
Presupuestosset_budget get_budget_status list_budgets update_budget delete_budget
Recurrentescreate_recurring list_recurring delete_recurring process_recurring
Proyectoscreate_project list_projects rename_project delete_project
Categoríaslist_categories add_category delete_category
Exportaciónexport_transactions export_invoices export_for_tax_advisor
Configuraciónget_profile set_profile get_notifications

Configuración

Configuración manual (si el instalador no funcionó)

Claude Desktop — edita tu archivo de configuración:

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

Claude Code:

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

Variables de entorno

VariableDescripciónPredeterminado
SPENDLOG_LANGUAGEen o deen
SPENDLOG_DATA_DIRRuta del directorio de datos~/.spendlog
DATABASE_PATHRuta completa a la base de datos SQLite$SPENDLOG_DATA_DIR/spendlog.db
SPENDLOG_PROJECTProyecto predeterminado para todas las transaccionesninguno

Privacidad

Todos los datos permanecen en tu máquina, en un archivo SQLite local. Sin cuenta, sin nube, sin telemetría — nada se envía a ningún lugar.

Nota: Spendlog es un rastreador de costos, no software de contabilidad. Úsalo para tus propios conocimientos, no para contabilidad oficial o declaración de impuestos.

Desarrollo

TypeScript (estricto), Vitest para pruebas, TypeORM + SQLite para almacenamiento.

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)

Consulta CONTRIBUTING.md para detalles de arquitectura y cómo agregar nuevas herramientas.

Licencia

MIT