# Clara — Tu asistente financiera con IA

> Source of truth: https://clara.trefolio.com
> License: MIT (open source)
> Repo: https://github.com/kyberis/etracker
> Maintainers: Trefolio (https://trefolio.com)
> MCP (public): https://clara.trefolio.com/api/mcp
> MCP (per-user, bearer): https://clara.trefolio.com/api/mcp/user

## Resumen

Clara es una asistente financiera con IA: planificá gastos, mirá tu balance mes a mes, mandá notas de voz por WhatsApp, importá extractos PDF y conectá tu banco vía Open Banking. Open source, MIT, self-hostable.

Hablale en castellano, mandale el PDF del banco, dictale una nota de voz por WhatsApp. Clara entiende, categoriza y mantiene tu balance al día. Less drama, more done.

Chat-first expense tracker con personalidad. Open source, MIT, self-hostable. Sin telemetría, sin precio por usuario, hablando rioplatense.

## Features

- **🤖 Lee tus extractos** — Tirá una captura del banco, un PDF o un CSV. Clara extrae los movimientos, sugiere categorías y siempre pregunta antes de tocar nada.
- **🎙️ Escucha notas de voz** — “Pagué el alquiler” por WhatsApp es suficiente. Clara transcribe, clasifica y actualiza el mes sin que abras la app.
- **🔄 Se sincroniza con tu banco** — Open Banking con solo lectura. Conectás tu banco una vez, sincronizás por mes, y Clara matchea transacciones con tus gastos planificados. Clara nunca tiene acceso a tu dinero.
- **📅 Organizada por mes** — Una plantilla define un gasto recurrente. Cada mes tiene su copia independiente que tildás cuando lo pagás.
- **🏦 Multi-banco real** — Cada gasto sabe en qué banco vive. Útil cuando repartís el alquiler entre tres cuentas y querés saber cuánto te queda en cada una.
- **📊 Visualiza solo cuando ayuda** — Clara no tira gráficos por tirar. Los renderiza inline solo cuando suman para entender lo que está pasando.
- **💬 Habla en rioplatense** — Sin inglés corporativo ni tuteo. Clara habla como una amiga contadora que sabe lo que hace — sin sermones, prometido.
- **🔓 Tu data es tuya** — Open source MIT. Self-hosteable en cualquier Vercel/Postgres. Sin telemetría, sin tracking, sin upsell de IA a $9.99/mes.
- **🤝 MCP para tu AI** — Clara expone un servidor MCP (Model Context Protocol). Conectalo a Claude Desktop, Cursor o ChatGPT y tu propio asistente puede consultar y actualizar tus finanzas con tu permiso.

## FAQ

### ¿Qué es Clara?

Clara es una asistente financiera con IA: un expense tracker conversacional que entiende fotos del banco, PDFs, CSVs y notas de voz por WhatsApp. Te ayuda a planificar tus gastos mes a mes, conectarte a tu banco vía Open Banking y mantener tu balance al día.

### ¿Cuánto cuesta?

Clara es 100% gratis y open source bajo licencia MIT. Podés correr la versión hosteada por nosotros sin pagar, o self-hostearla en tu propio Vercel + Postgres. No tenemos suscripciones, ni precio por usuario, ni features pagas.

### ¿Cómo procesa los PDFs y extractos bancarios?

Clara usa modelos de lenguaje multimodales vía Vercel AI Gateway para extraer movimientos de PDFs, capturas y CSVs. El procesamiento corre en Vercel Functions: el archivo se sube a Vercel Blob temporalmente, el modelo extrae los datos, y Clara te muestra una propuesta antes de guardar nada en tu base de datos.

### ¿Qué bancos soporta?

Para conexión automática (Open Banking) Clara soporta la mayoría de bancos europeos y del Reino Unido. La conexión es de solo lectura: Clara nunca tiene acceso a tu dinero, solo lee los movimientos. Para cualquier banco del mundo podés importar PDFs/CSVs o registrar gastos manualmente vía chat o nota de voz.

### ¿Cómo funciona la integración con WhatsApp?

Linkeás tu número desde Configuración (te llega un código por WhatsApp). Después podés mandarle a Clara notas de voz, fotos o texto: ella transcribe, clasifica el gasto y te confirma antes de actualizar el mes.

### ¿Qué hace con mis datos?

Tus datos viven en tu base de datos Postgres (la nuestra si usás la versión hosteada, la tuya si self-hosteás). No hay telemetría, no se venden datos, no se entrenan modelos con tu información. Para LLM usamos Vercel AI Gateway en modo zero data retention.

### ¿En qué idiomas funciona?

Clara funciona en español rioplatense (default) e inglés. Podés cambiar el idioma desde el menú o pidiéndoselo a Clara directamente en el chat. La UI completa, las páginas públicas y el agente respetan la elección.

### ¿Puedo usar Clara con mi propio AI assistant (Claude, Cursor, ChatGPT)?

Sí. Clara expone un servidor MCP (Model Context Protocol) en /api/mcp/user. Generás un token desde Configuración → Acceso para AI, lo pegás en Claude Desktop, Cursor o cualquier cliente MCP, y tu asistente puede listar tus meses, consultar balance, agregar gastos y marcar como pagado — siempre con tu permiso.

### ¿Es self-hostable?

Sí. El stack es Next.js 16 + Postgres + Prisma + Vercel AI SDK. Cloneás el repo, configurás .env (DATABASE_URL, NEXTAUTH_SECRET, AI_GATEWAY_API_KEY), corrés las migraciones, y deployás a Vercel con un click. La guía completa está en el README.

### ¿Cómo se compara con otras apps de finanzas?

Mint, YNAB, Fintonic y similares son planillas con mejor diseño: filas, categorías y reportes. Clara es chat-first: hablás con ella en lenguaje normal, le mandás un PDF y entiende, le mandás una nota de voz y registra el gasto. La IA es el núcleo del producto, no una feature de marketing. Y es open source.


## Privacidad

### Qué datos recolecta Clara

Clara solo guarda lo necesario para funcionar como tracker de gastos: tu email, los bancos que registres, las plantillas y líneas de gasto que crees, los movimientos que sincronices vía Open Banking y, opcionalmente, tu número de WhatsApp para recibir notas por ese canal.

Si usás la versión hosteada por Trefolio, los datos viven en una base Postgres administrada en Europa. Si self-hosteás, viven donde vos los pongas.

### Qué NO hace Clara

No tiene telemetría: no medimos clicks, sesiones ni eventos de uso para analytics.

No vende datos a terceros y no monetiza tu información.

No entrena modelos con tu información: usamos Vercel AI Gateway con zero data retention para todas las llamadas LLM.

Nunca tiene acceso a tu dinero: la conexión bancaria vía Open Banking es estrictamente de solo lectura.

### Procesamiento por IA

Para entender tus mensajes, transcribir voz y procesar PDFs, Clara manda contenido a modelos de lenguaje a través de Vercel AI Gateway. Esos providers operan bajo políticas zero data retention: el contenido se procesa y se descarta, no se usa para entrenamiento.

Los archivos que subís (PDFs, capturas) se almacenan en Vercel Blob el tiempo necesario para procesarlos y se borran después.

### Tus derechos

Podés exportar todos tus datos vía la API o pedirnos un dump completo. Podés borrar tu cuenta desde Configuración; cuando lo hacés, eliminamos toda tu información en cascada (gastos, meses, conexiones bancarias, mensajes de WhatsApp, tokens MCP).

Si tenés dudas sobre privacidad o querés ejercer un derecho específico (acceso, rectificación, portabilidad), escribinos abriendo un issue en GitHub.


## Changelog

### v0.1.0 · 2026-04-28 — Apertura pública de Clara

- Landing pública con SEO completo y soporte para AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended).
- Servidor MCP público en /api/mcp para que AI assistants conozcan Clara.
- Servidor MCP autenticado por usuario en /api/mcp/user con tokens MCP gestionados desde Configuración.
- llms.txt y llms-full.txt para descubrimiento por LLMs.

### v0.0.9 · 2026-04-15 — Open Banking con Revolut

- Conexión automática de solo lectura con bancos europeos vía Open Banking.
- Sincronización por mes y matching contra plantillas planificadas.
- UI nueva en Configuración para conectar/desconectar y configurar el banco por defecto.

### v0.0.8 · 2026-04-01 — WhatsApp como inbox principal

- Notas de voz transcritas por Whisper y clasificadas por el agente.
- Respuestas en audio vía OpenAI TTS subidas a Vercel Blob.
- Linking de número vía código de un solo uso desde Configuración.


## Cómo conectar Clara a tu AI assistant (Claude, ChatGPT, Cursor)

Clara expone dos servidores MCP (Model Context Protocol):

1. **Público — `https://clara.trefolio.com/api/mcp`**
   Sin auth. Expone documentación pública (features, FAQ, changelog, privacy) como resources y tools. Apto para que el AI conozca Clara y pueda responder preguntas sobre el producto.

2. **Por usuario — `https://clara.trefolio.com/api/mcp/user`**
   Autenticado por bearer token. Generás un token desde Settings → Acceso para AI (la app web). Pegás el token en el cliente MCP (Claude Desktop, Cursor, etc.) y tu asistente puede listar tus meses, consultar balance, agregar gastos, marcar líneas como pagado, etc., siempre con tu permiso explícito.

Configuración para Claude Desktop / Cursor (mcp.json):

```json
{
  "mcpServers": {
    "clara": {
      "url": "https://clara.trefolio.com/api/mcp/user",
      "headers": { "Authorization": "Bearer <ada_pat_…>" }
    }
  }
}
```

## Stack técnico

- Next.js 16 (App Router) sobre Vercel Fluid Compute
- React 19, Tailwind CSS 4
- Prisma 7 + Postgres
- Vercel AI SDK v6 + Vercel AI Gateway (multi-provider, zero data retention)
- NextAuth (credentials + Google OAuth)
- Vercel Blob para archivos
- Twilio para WhatsApp (texto, imágenes, voz)
- Whisper para transcripción de voz, OpenAI TTS para respuesta en audio
- GoCardless Bank Account Data para Open Banking

## Soporte

- Issues: https://github.com/kyberis/etracker/issues
- Sitio del equipo: https://trefolio.com