ledgr
Ledgr is a self-hostable, open-source personal finance application built on Next.js/TypeScript that connects to bank accounts via Plaid or SimpleFIN, automates categorization, tracks budgets and investments, and exposes an MCP server for AI agents.
Ficha actualizada 23 sept 2026, 1:57 · upstream 23 sept 2026, 1:30 · release sin release detectada
Qué es ledgr
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Ledgr provides complete financial control by connecting to over 12,000 banks through Plaid (or SimpleFIN as a no-code alternative). It features automatic transaction syncing with intelligent four-tier categorization: user rules > merchant defaults > Plaid categories > AI fallback. The platform delivers budgets across all spending areas, investment portfolio tracking synced from bank data, recurring bill detection, and comprehensive financial reports including net worth calculations. A built-in MCP server enables natural language queries of your finances through Claude Code, Cursor, or any Model Context Protocol client.
- Automatically categorize every transaction across 12,000+ banks without manual entry
- Set monthly budgets per category and track spending progress in real time
- Monitor investment portfolio performance with automatic holdings sync from Plaid or SimpleFIN
- Detect recurring bills automatically to avoid unexpected charges
- Generate personalized financial reports showing income, expenses, cash flow, and net worth trends
- Query your finances using natural language via AI agents like Claude Code
- Supports over 12,000 banks through Plaid with real-time webhook sync or scheduled polling
- Four-tier categorization pipeline that progressively refines transaction classification
- Built-in MCP server enables AI agents to query finances via natural language prompts
- Self-hosted architecture with PostgreSQL and no data leaves your infrastructure
- BYOK (Bring Your Own Key) model allows custom AI providers like OpenAI, Anthropic, or local models
- Requires Docker Compose for deployment; not a standalone binary
- Plaid requires paid developer accounts beyond the free trial and sandbox access
- SimpleFIN sync is limited to daily schedules rather than real-time webhook notifications
- AI categorization relies on user-defined rules with fallbacks that may misclassify complex transactions
- Investment tracking only supports holdings synced from Plaid or SimpleFIN; other platforms require manual entry
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Install via `curl -fsSL https://raw.githubusercontent.com/KenTaniguchi-R/ledgr/main/scripts/install.sh` which creates a `ledgr/` directory with `docker-compose.yml`. Run `docker compose up -d` to start the app. Use `.env.example` for configuration, ensuring you set `ENCRYPTION_KEY` and `BETTER_AUTH_SECRET` before production use. For development, run `pnpm dev:setup` to initialize the database and migrate schema. The MCP endpoint is available at `/api/mcp`; enable it in your environment file with `MCP_ENABLED=true`. Always back up your encrypted data volume as losing the encryption key permanently deletes all bank tokens.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.