Project Memory
Processes WhatsApp conversations to build a personal CRM, providing tools for contact summarization, semantic search of chat history, and reminder management based on conversation context.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Project MemorySummarize my latest conversations with Maria"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Project Memory 🧠
CRM personal inteligente que procesa conversaciones de WhatsApp para construir conocimiento sobre tus contactos, expuesto vía Model Context Protocol (MCP).
✨ Características
Procesamiento de Audio: Diarización (pyannote) + Transcripción (Groq Whisper)
Identificación de Hablantes: Distingue tu voz de la del contacto
Privacidad: Sanitización de PII con Microsoft Presidio (RUT, teléfonos, emails)
Extracción Inteligente: Qwen 3 32B via Groq para extraer hechos, sentimientos, temas
Búsqueda Semántica: pgvector para encontrar conversaciones por contexto
MCP Server: Expone tools para usar con Claude Desktop
Related MCP server: WhatsApp MCP Server
🏗️ Arquitectura
WhatsApp → WaHA → n8n → Redis → Worker Python → PostgreSQL
↓
Claude Desktop ← MCP Server🚀 Quick Start
# 1. Clonar
git clone https://github.com/crtormo/project-memory.git
cd project-memory
# 2. Configurar
cp .env.example .env
# Editar .env con tus API keys
# 3. Levantar
docker-compose up -d
# 4. Vincular WhatsApp
# Abrir http://localhost:3000 y escanear QR🔧 Configuración
Variables de Entorno
Variable | Descripción |
| Token para pyannote (diarización) |
| API key de Groq (Whisper + Qwen) |
| API key de Google AI Studio (fallback) |
Servicios Docker
Servicio | Puerto | Descripción |
PostgreSQL | 5432 | Base de datos + pgvector |
Redis | 6379 | Cola de mensajes |
WaHA | 3000 | API WhatsApp |
n8n | 5678 | Automatización |
🛠️ Herramientas MCP
Tool | Descripción |
| Resumen completo de un contacto |
| Búsqueda semántica en historial |
| Crear recordatorio |
| Ver recordatorios próximos |
| Listar todos los contactos |
Configurar Claude Desktop
Agregar a ~/.claude/config.json:
{
"mcpServers": {
"project-memory": {
"command": "docker",
"args": ["exec", "-i", "project-memory-mcp", "python", "-m", "src.mcp_server.server"]
}
}
}📁 Estructura
project-memory/
├── src/
│ ├── core/ # AudioProcessor, PrivacyService, Intelligence
│ ├── database/ # Models, Repositories, Connection
│ ├── services/ # BatchProcessor, MessageQueue, Notifications
│ └── mcp_server/ # Servidor MCP con tools
├── scripts/ # CLI utilities
├── docker/ # Dockerfiles
└── n8n/ # Workflows📊 Stack Tecnológico
Python 3.11 + Poetry
PostgreSQL 16 + pgvector
Redis 7 para cola de mensajes
pyannote.audio para diarización
Groq API (Whisper + Qwen 3 32B)
Microsoft Presidio para PII
MCP SDK para Model Context Protocol
📝 Scripts CLI
# Verificar BD
python scripts/init_db.py
# Registrar tu voz
python scripts/enroll_voice.py
# Exportar datos
python scripts/export_data.py contacts --format csv
# Ver recordatorios
python scripts/check_reminders.py🔒 Seguridad
Las API keys nunca se commitean (están en
.env)PII sanitizado antes de persistir
Datos almacenados localmente (Home Lab)
📄 Licencia
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
An AI-first personal CRM you run in natural language: contacts, reminders, notes, and more.
Personal CRM for Claude. Contacts live as plain-text files in your own Google Drive.
WhatsApp CRM for AI agents: search contacts, read chats, manage the sales pipeline, send messages.
Let Claude or ChatGPT search, read and send your WhatsApp messages over MCP. OAuth sign-in.
Related MCP Servers
- AlicenseCqualityFmaintenanceA Model Context Protocol server that connects your personal WhatsApp account to AI agents like Claude, enabling them to search messages, view contacts, retrieve chat history, and send messages via WhatsApp.712 npm73ISC
- FlicenseNot gradedqualityNot gradedmaintenanceEnables seamless integration with WhatsApp through the Model Context Protocol, featuring multi-user support and Supabase cloud storage for persistent message history and media. Users can send messages, search chat records, and manage contacts across platforms like Claude Desktop, Cursor, and OpenClaw.-
- AlicenseNot gradedqualityDmaintenanceEnables Claude to interact with WhatsApp Business for reading, searching, and sending end-to-end encrypted messages. It supports conversation management, message summarization, and action item tracking while maintaining data privacy through a local private key and a user-controlled Neon database.19 npmMIT
- AlicenseAqualityBmaintenanceEnables Claude to interact with WhatsApp on macOS through the Model Context Protocol. It allows reading messages, searching contacts, listing chats, and sending replies via natural conversation.282MIT