01 Qué es Auto-CRM y para quién tiene sentido
Auto-CRM es una aplicación web (Next.js, SQLite y Drizzle) que instalas y ejecutas en tu equipo. Trae lo que se espera de un CRM sencillo: panel con indicadores, embudo de ventas tipo kanban con arrastrar y soltar, fichas de contacto con historial, avisos de seguimiento, puntuación de leads y exportación a CSV. La diferencia es que viene preparado para Claude Code: incluye un CLAUDE.md y comandos propios para que lo adaptes a tu forma de vender hablando en español.
Tiene sentido para autónomos, consultores, agencias pequeñas y negocios locales que hoy llevan los clientes en una hoja de cálculo y no quieren pagar una suscripción por usuario. Si necesitas que diez comerciales trabajen a la vez desde la calle, un CRM en la nube te encajará mejor.
Datos en tu equipo
La base de datos es un archivo en data/crm.db dentro del proyecto. No depende de servicios externos para funcionar.
Embudo a tu medida
Etapas, fuentes de leads, idioma y tema visual se configuran con el comando /setup.
Leads automáticos
Un webhook recibe contactos desde formularios web y los crea en el CRM.
Conectado a Claude
Servidor MCP propio para consultar y añadir datos desde Claude Desktop.
02 Instalación paso a paso
- ✓Comprueba Node.js con node --version (necesitas la versión 20 o una LTS posterior).
- ✓Comprueba Claude Code con claude --version.
- ✓Ten git instalado, o descarga el proyecto como ZIP desde GitHub y descomprímelo.
git clone https://github.com/Hainrixz/auto-crm.git
cd auto-crm
npm install
npm run devAbre http://localhost:3000 en el navegador y verás el panel vacío. Mientras la terminal siga abierta, el CRM está en marcha. Si quieres explorarlo con datos de ejemplo antes de meter los tuyos, ejecuta npm run init:seed.
# Uso diario (compila y arranca en modo producción)
npm run local
# En un contenedor Docker, con los datos en ./data
docker compose up -d
docker compose down03 Personalízalo con Claude Code
Abre Claude Code dentro de la carpeta del proyecto (claude) y ejecuta /setup. Te preguntará por tu tipo de negocio, las etapas de tu embudo, de dónde llegan tus leads, el idioma y el tema visual, y modificará el CRM en consecuencia.
| Comando | Qué hace |
|---|---|
| /setup | Configuración inicial adaptada a tu negocio |
| /add-lead | Añadir un lead conversando, sin rellenar formularios |
| /analyze-pipeline | Análisis del embudo con recomendaciones |
| /daily-briefing | Resumen ejecutivo del día |
| /import-contacts | Importación guiada desde CSV |
| /customize | Cambiar la configuración más adelante |
| /connect | Conectar con Gmail, Calendar, Sheets o WhatsApp |
| /digest | Enviar el resumen diario por correo |
Soy [TIPO DE NEGOCIO, p. ej. estudio de reformas en Valencia]. Mis etapas reales son: primer contacto, visita técnica, presupuesto enviado, negociación, aceptado y perdido. Los leads llegan por la web, por recomendación y por Instagram. Adapta el CRM: etapas, fuentes, un campo «tipo de obra» en los contactos y un aviso si un presupuesto lleva más de 7 días sin respuesta. Explícame qué archivos cambias antes de hacerlo./import-contacts
El archivo es clientes-2025.csv, exportado de Excel con separador punto y coma. Antes de importar, enséñame cómo vas a mapear cada columna, detecta duplicados por correo o teléfono y avísame de las filas con datos incompletos.04 Leads automáticos, IA y conexión con Claude
Webhook. El CRM acepta peticiones POST en /api/webhook y reconoce nombres de campo en español e inglés (nombre, correo, telefono, empresa…), además del formato de Typeform.
curl -X POST http://localhost:3000/api/webhook \
-H "Content-Type: application/json" \
-d '{"nombre":"Lucía Gómez","correo":"[email protected]","telefono":"600000000","empresa":"Gómez Interiorismo"}'Variables opcionales. Copia .env.example a .env.local y rellena solo lo que vayas a usar: ANTHROPIC_API_KEY para que la web clasifique leads con Claude (sin ella usa reglas), y RESEND_API_KEY, DIGEST_EMAIL y DIGEST_FROM para el resumen diario por correo.
MCP. El proyecto incluye un servidor MCP en mcp/crm-server.ts con herramientas para listar y buscar contactos, ver tratos, métricas y seguimientos. En Claude Desktop se añade con este bloque en claude_desktop_config.json, cambiando la ruta por la tuya:
{
"mcpServers": {
"auto-crm": {
"command": "npx",
"args": ["tsx", "/ruta/a/auto-crm/mcp/crm-server.ts"]
}
}
}Usando el CRM, dime: qué tratos llevan más de 10 días sin actividad, qué leads calientes no tienen siguiente paso, y el valor total por etapa comparado con la semana pasada si hay datos. Propón las cinco acciones más rentables para hoy, con el contacto y el mensaje sugerido.05 Datos de clientes: lo que debes cuidar
- ✓Haz copias de seguridad periódicas de data/crm.db: si se borra o se estropea el disco, no hay otra copia.
- ✓Sigues siendo responsable del tratamiento de datos personales (RGPD): informa a tus contactos y guarda solo lo necesario.
- ✓No publiques el CRM en internet tal cual. Si expones el webhook, configura su secreto (el CRM lo exige en la cabecera x-webhook-secret cuando está definido) y pon el servicio detrás de HTTPS.
- ✓Cifra el disco del equipo donde vive el CRM, sobre todo si es un portátil.
- ✓Las claves de .env.local no se comparten ni se suben a repositorios.
Preguntas frecuentes
No para usarlo. Los comandos funcionan con tu sesión de Claude Code y la clasificación de leads de la web usa reglas si no hay clave. La clave de Anthropic solo añade la clasificación con IA desde la propia interfaz.
Está pensado para uso local. Para compartirlo tendrías que desplegarlo en un servidor (por ejemplo con Docker), protegerlo con autenticación y HTTPS, y asumir su mantenimiento.
Puedes exportar contactos y tratos a CSV desde la interfaz o desde la API de exportación, y la base de datos SQLite es un archivo que puedes abrir con cualquier herramienta compatible.
Sí, es código abierto con licencia MIT. Solo pagarías servicios opcionales que conectes, como el envío de correos o la API de Claude.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.