Nineteen Blocks Sales Automation

Un sistema de automatización de ventas que integra Gmail, Google Sheets, Streak CRM, Notion y Google Drive en un flujo de trabajo unificado.

GitHubPrueba este MCPPatrocinado

Documentación

Nineteen Blocks Sales Automation MCP

Un sistema integral de automatización de ventas que utiliza el Protocolo de Contexto de Modelos (MCP) e integra Gmail, Google Sheets, Streak CRM, Notion y Google Drive en un flujo de trabajo unificado accesible a través de Claude Desktop.

Características

✅ Totalmente Implementado (28 Herramientas Funcionales)

  • Integración con Gmail

    • Verificar respuestas de prospectos
    • Encontrar correos que necesitan seguimiento
    • Buscar correos con criterios personalizados
    • Identificar solicitudes de reuniones
    • Descargar y organizar archivos adjuntos

  • Integración con Google Sheets

    • Actualizaciones rápidas de acuerdos usando lenguaje natural
    • Leer datos del pipeline con estadísticas resumidas
    • Agregar nuevos acuerdos al pipeline
    • Fórmulas inteligentes para cálculos de ventas

  • Integración con Google Drive

    • Organizar automáticamente archivos adjuntos de correos por empresa
    • Crear carpetas estructuradas de acuerdos
    • Buscar documentos en Drive
    • Compartir archivos en lote con el equipo
    • Rastrear archivos modificados recientemente

  • Integración con Streak CRM

    • Sincronizar hilos de Gmail con acuerdos
    • Actualizar etapas y valores de acuerdos
    • Crear nuevos acuerdos con contexto de correo
    • Análisis avanzado del pipeline
    • Encontrar acuerdos obsoletos que necesitan atención

  • Integración con Notion

    • Crear notas de reuniones con plantillas
    • Actualizar el estado de acuerdos entre bases de datos
    • Construir perfiles de contacto con historial de correos
    • Generar informes semanales automatizados
    • Buscar en todo el contenido de Notion

  • Características Multiplataforma

    • Crear acuerdos simultáneamente en TODAS las plataformas
    • Sincronización bidireccional entre plataformas
    • Informes y análisis unificados
    • Organización inteligente de archivos

🚧 Próximamente

  • Integración con Dropbox
  • Procesamiento de transcripciones con Otter.ai
  • Programación automatizada
  • Información impulsada por IA

🎯 ¿Qué Puede Hacer?

Este servidor MCP convierte a Claude en tu asistente de ventas con IA que puede:

  1. Gestionar Acuerdos Entre Plataformas - Crea un acuerdo una vez y aparece en Sheets, Streak, Notion y Drive
  2. Rastrear Comunicaciones por Correo - Monitorea respuestas, encuentra seguimientos necesarios y sincroniza hilos con tu CRM
  3. Organizar Archivos Automáticamente - Descarga archivos adjuntos y organízalos por empresa en Google Drive
  4. Mantener Todo Sincronizado - La sincronización bidireccional asegura que todas las plataformas tengan los datos más recientes
  5. Generar Informes Unificados - Ve todo tu pipeline en todas las plataformas en una sola vista

🚀 Inicio Rápido

Requisitos Previos

  • Node.js 18+
  • Claude Desktop
  • Cuentas para los servicios que quieras integrar

Instalación

# Clone the repository
git clone https://github.com/YOUR_USERNAME/nineteen-blocks-sales-automation-mcp.git
cd nineteen-blocks-sales-automation-mcp

# Install dependencies
npm install

# Copy and configure environment variables
cp config/.env.example config/.env
# Edit config/.env with your credentials

# Verify setup
npm run test:integrations

Agregar a Claude Desktop

Agrega esto a tu configuración de Claude Desktop:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sales-automation": {
      "command": "node",
      "args": ["/absolute/path/to/nineteen-blocks-sales-automation-mcp/src/server.js"]
    }
  }
}

¡Reinicia Claude Desktop y comienza a usar comandos de lenguaje natural!

📚 Ejemplos de Comandos

"Create a deal workspace for Acme Corp worth $50,000"
"Check if john@example.com responded to my email"
"Download all attachments from sarah@client.com"
"Sync all platforms"
"Show me deals that haven't been updated in 2 weeks"
"Generate a unified sales report"

📖 Guía de Configuración Completa

Consulta SETUP.md para instrucciones detalladas sobre:

  • Obtener credenciales para cada servicio
  • Configurar cuentas de Google Workspace
  • Configurar bases de datos y pipelines
  • Solucionar problemas comunes

Herramientas Disponibles

Herramientas de Correo

  • check_prospect_response - Verificar si un prospecto ha respondido
  • find_follow_up_needed - Encontrar prospectos que necesitan seguimiento
  • find_meeting_requests - Identificar solicitudes de reuniones
  • search_emails - Buscar con criterios personalizados

Herramientas de Hojas de Cálculo

  • quick_deal_update - Actualizar acuerdos usando lenguaje natural
  • read_pipeline_data - Obtener resumen del pipeline
  • add_new_deal - Agregar nuevos acuerdos
  • add_smart_formulas - Agregar cálculos de ventas

Desarrollo

Estructura del Proyecto

src/
├── server.js           # Main MCP server
├── integrations/       # Platform integrations
│   ├── gmail.js
│   ├── sheets.js
│   └── ...
├── tools/             # MCP tool definitions
│   ├── email-tools.js
│   ├── sheets-tools.js
│   └── ...
└── utils/             # Utilities
    └── scheduler.js   # Cron jobs

Agregar Nuevas Herramientas

  1. Crear la definición de la herramienta en el archivo tools/ correspondiente
  2. Implementar la lógica de integración en integrations/
  3. Exportar desde el módulo de herramientas
  4. Probar con Claude Desktop

Solución de Problemas

Problemas de Conexión con Gmail

  • Asegúrate de que la verificación en dos pasos esté habilitada
  • La contraseña de aplicación debe tener 16 caracteres (sin espacios)
  • Verifica que IMAP esté habilitado en la configuración de Gmail

Acceso Denegado a Google Sheets

  • Verifica que la cuenta de servicio haya sido compartida con la hoja
  • Comprueba que la API esté habilitada en Google Cloud Console
  • Asegúrate de que la ruta del archivo de clave JSON sea correcta

Herramienta No Encontrada

  • Reinicia Claude Desktop después de cambios en la configuración
  • Revisa los registros del servidor para ver errores
  • Verifica que la herramienta esté exportada desde el módulo

🌐 Despliegue en GitHub

Para compartir este proyecto:

  1. Crea un repositorio en GitHub

  2. Inicializa git y haz push:

    git init
git add .
git commit -m "Initial commit - Sales Automation MCP"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/nineteen-blocks-sales-automation-mcp.git
git push -u origin main

  3. Importante: Asegúrate de agregar .env a .gitignore para mantener las credenciales seguras:

    echo "config/.env" >> .gitignore
echo "config/service-account-key.json" >> .gitignore
git add .gitignore
git commit -m "Add gitignore for sensitive files"
git push

🔒 Notas de Seguridad

  • Nunca subas tu archivo .env ni las claves de cuenta de servicio
  • Usa variables de entorno para todos los datos sensibles
  • Comparte cuentas de servicio con los permisos mínimos requeridos
  • Rota regularmente las claves de API y contraseñas

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Por favor:

  1. Haz un fork del repositorio
  2. Crea una rama de características
  3. Realiza tus cambios
  4. Envía una solicitud de pull

📝 Licencia

Licencia MIT - ¡Siéntete libre de usar esto en tus propios proyectos!

🆘 Soporte

Para problemas o preguntas:

  1. Consulta SETUP.md para instrucciones detalladas de configuración
  2. Revisa los registros del servidor para ver errores
  3. Crea un issue en GitHub

Hecho con ❤️ para el equipo de ventas de Nineteen Blocks