Buzonero Campillero

Buzonero es un servidor MCP que da a Claude Code, Cursor, Codex, Windsurf o Claude Desktop acceso a varias cuentas de Gmail y Google Workspace a la vez. Puedes buscar en todas de una vez, leer, dejar borradores, responder y reenviar, archivar, poner etiquetas de color, darte de baja de boletines, seguir tus paquetes o pedir que te avise si alguien no contesta.

Y trae su app web (una PWA que se instala en el ordenador y en el móvil), que va mucho más allá del correo:

• Correo de todas tus cuentas en pestañas: bandeja agrupada por meses, búsqueda de Gmail, redactar con adjuntos, deshacer el envío, dictado por voz y «Avísame si no contesta».

• CRM: un tablero por etapas que detecta solo los leads que llegan por correo y por WhatsApp, y te dice de quién es el turno.

• WhatsApp (solo lectura) a través de Zernio: lees las conversaciones, cada una es un lead del CRM y te avisa en el móvil cuando entra un mensaje.

• Calendario de Google (día, semana y mes) y Contactos de Google (nombres y fotos para los números de WhatsApp).

• Redes sociales: un planificador al estilo de Metricool, con calendario semanal, para programar tus publicaciones desde tu cuenta de Metricool.

• Integraciones: un panel con todo lo que se puede conectar, y solo aparece en la barra lateral lo que de verdad usas.

• Además: paquetes, suscripciones, basura parada, avisos al móvil y 12 temas.

Cada persona se lo instala gratis, en su propio Vercel y con su propio proyecto de Google. Tu correo no pasa por ningún servidor ajeno, tampoco por el de quien escribió esto.

Instalar en 1 paso

Copia esto en tu agente de IA:

Instálame Buzonero Campillero: https://github.com/alerl25/buzonero-campillero
Sigue su AGENTS.md y guíame paso a paso.

Tu agente lo clona, lo publica en tu Vercel, genera las claves y se conecta el MCP. A ti solo te pide unos clics en Google Cloud, Vercel y cron-job.org, y te dice exactamente qué poner. Calcula 20-30 minutos.

¿Prefieres hacerlo a mano? Tienes la guía completa en INSTALAR.md.

Related MCP server: Gmail Multi-Inbox MCP Server

El MCP: 39 herramientas para tu agente

Prueba a pedirle a tu agente:

• «¿Qué tengo sin leer en todas mis cuentas?»

• «Responde a Laura desde la cuenta del trabajo diciendo que el jueves me va bien» (deja un borrador).

• «Date de baja de los boletines que nunca abro.»

• «¿Qué paquetes tengo de camino?»

• «Avísame si el proveedor no contesta en 3 días.»

• «Archiva todo lo de LinkedIn de más de una semana en las tres cuentas.»

• «¿Qué me han escrito hoy por WhatsApp?» (solo lee: no contesta ni marca nada como leído).

Guarda la clave del MCP (el contenido de clave-mcp.txt) en ~/.config/buzonero/mcp-key.txt. RUTA es la carpeta donde clonaste el repositorio y TU-APP es tu dirección de Vercel.

Claude Code

claude mcp add buzonero --scope user -e BUZONERO_URL=https://TU-APP.vercel.app -- node "RUTA/mcp/buzonero-mcp.mjs"

Cursor (~/.cursor/mcp.json), Windsurf y Claude Desktop

{
  "mcpServers": {
    "buzonero": {
      "command": "node",
      "args": ["RUTA/mcp/buzonero-mcp.mjs"],
      "env": { "BUZONERO_URL": "https://TU-APP.vercel.app" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "buzonero": {
      "type": "stdio",
      "command": "node",
      "args": ["RUTA/mcp/buzonero-mcp.mjs"],
      "env": { "BUZONERO_URL": "https://TU-APP.vercel.app" }
    }
  }
}

Codex (~/.codex/config.toml)

[mcp_servers.buzonero]
command = "node"
args = ["RUTA/mcp/buzonero-mcp.mjs"]
env = { BUZONERO_URL = "https://TU-APP.vercel.app" }

La app

Las capturas usan una persona, unos correos, unos teléfonos y unas marcas inventados (scripts/capturas-demo.mjs).

Correo

• Varias cuentas en pestañas, cada una con su color y su contador de sin leer.

• Categorías de Gmail (Principal, Promociones, Social, Notificaciones), carpetas y etiquetas de color. El color lo eliges al crear la etiqueta o tocando su cuadradito.

• Bandeja agrupada por meses y búsqueda con la sintaxis de Gmail.

• Acciones en bloque, y deslizar para archivar en el móvil.

• El correo se ve con tu tema, también en oscuro. La parte citada sale plegada y los adjuntos tienen visor (PDF, imágenes y documentos).

• Redactar y responder con adjuntos (los grandes van a Drive), una firma por cuenta y borradores que se guardan solos.

• Deshacer el envío durante 10 segundos.

• Dictado por voz: limpia muletillas y entiende «punto y aparte», «coma», «interrogación»…

• «Avísame si no contesta»: si nadie responde en el plazo que elijas, el hilo vuelve a tu bandeja con la etiqueta «Sin respuesta» y te llega un aviso.

Lo que encuentra por ti

• Añadir al calendario: detecta fechas y horas en el correo y crea el evento en Google Calendar.

• Teléfonos y direcciones: los convierte en botones de llamada, WhatsApp y mapa.

• Calendario de Google: Día, Semana y Mes de todos tus calendarios en una pestaña, con un check por cuenta y por calendario como en Google Calendar. Crear, editar, arrastrar y borrar eventos desde aquí.

• Paquetes: reúne en una pestaña los pedidos y envíos de todas las cuentas, con su estado.

• Suscripciones: lista los boletines y te deja darte de baja en un clic o filtrarlos. Te señala los que nunca abres.

• Basura parada: cuenta lo que tus filtros apartan cada semana.

CRM (botón «CRM» de la barra lateral)

• Tablero por etapas (Nuevo, Respondido, Propuesta, Reserva, Ganado, Perdido; las cambias tú) y arrastrar tarjetas entre ellas. Cada tarjeta dice si te toca contestar o si estás esperando.

• Un CRM por negocio, con sus cuentas de correo. Pestañas: Tablero, Clientes, Integraciones y Ajustes.

• Detecta los leads solo: formularios de tu web, correos directos de personas nuevas y palabras clave que eliges; aparta los bots y tiene «No es lead». La etapa de cada lead es una etiqueta de tu Gmail (Leads/…), así que también la ves desde Gmail.

• Todo lo que llega por WhatsApp es un lead, sin filtrar (integración «WhatsApp (Zernio)»); solo cuentan las conversaciones con movimiento en los últimos 7 días, para que las viejas y cerradas no engorden el tablero.

• Etapas automáticas: si contestas, pasa a Respondido; con Nexudus conectado, una reserva lo pasa a Reserva y una factura pagada a Ganado.

• «Añadir al CRM» en cualquier correo.

WhatsApp (solo lectura, por Zernio)

• Lista de conversaciones con el chat al lado. Es de solo lectura por diseño: no hay en el servidor ningún camino para enviar, y no marca los mensajes como leídos (en WhatsApp eso mandaría el doble check azul al cliente).

• Nombres legibles: el nombre que tú pones («Poner nombre»), el que trae WhatsApp o, si no hay, el número bien escrito (+34 600 55 05 78).

• Fotos de perfil: WhatsApp no las da a las empresas. Si conectas tus Contactos de Google, salen el nombre y la foto de quien tengas en tu agenda; si no, unas iniciales de color.

• Se actualiza solo, como el correo: cada 10 segundos con la vista abierta, también la conversación que estás leyendo, sin saltos de pantalla.

• Aviso al móvil cuando entra un WhatsApp nuevo (solo de lo que escribe el cliente, no de tus respuestas).

• El panel vacío lleva un icono de partículas, como el sobre del correo.

• Solo sale en la barra lateral si tienes un WhatsApp conectado.

Redes sociales (planificador al estilo de Metricool)

• Calendario semanal de lunes a domingo, de 0:00 a 23:59: cada publicación programada en su día y su hora, con el color de su red; las que se pisan se reparten en columnas; línea de la hora actual; «Esta semana», flechas y selector de marca. También hay vista Listado.

• Pulsar un hueco libre abre «Crear publicación» con esa hora; pulsar una publicación la abre con su texto entero y el enlace a Metricool.

• Crear publicación: texto, redes de esa marca (Facebook, Instagram, LinkedIn, TikTok, X, Bluesky, Threads y Google Business), día y hora, y enlaces https de imágenes o vídeos. Pide confirmación y solo se programa cuando tú lo pulsas.

• Se conecta a tu cuenta de Metricool de dos maneras: por MCP (entras en Metricool y das permiso; vale en cualquier plan, sin token) o por API (con tu token; planes Advanced o Custom de Metricool).

• Solo sale en la barra lateral si Metricool está conectado. Con la conexión por MCP no se puede editar ni borrar desde aquí (Metricool no ofrece esa herramienta): se hace en Metricool.

Integraciones (botón siempre visible de la barra lateral)

Un solo sitio para ver y gestionar todo lo que se puede conectar (la tabla completa está más abajo).

Avisos y móvil

• Avisos de correo nuevo y de WhatsApp nuevo en el móvil y en el ordenador (Web Push, también en iPhone). La publicidad no avisa.

• Globo con el número de sin leer en el icono de la app.

• Se instala como app en iPhone, Android y escritorio.

A tu gusto

• Claro, oscuro y 12 temas con personalidad propia: letra, esquinas, textura de fondo y partículas animadas (nieve, burbujas, luciérnagas, estrellas, píxeles, confeti…).

Las integraciones

Todo es opcional salvo Gmail. Se gestiona desde el botón Integraciones de la barra lateral.

Cómo funciona

flowchart LR
  A["Tu agente de IA<br/>(Claude Code, Cursor, Codex…)"] -- "MCP · stdio" --> M["mcp/buzonero-mcp.mjs<br/>en tu ordenador"]
  M -- "token de 1 h<br/>(clave del MCP)" --> V["Tu Vercel<br/>api/ (sin base de datos)"]
  W["App web / PWA<br/>en tu móvil y PC"] -- "token de 1 h<br/>(sesión)" --> V
  V -- "permisos cifrados<br/>AES-256-GCM" --> D[("Tu Google Drive")]
  M -- "API de Gmail" --> G["Gmail · Drive · Contactos"]
  W -- "API de Gmail" --> G
  C["cron-job.org<br/>cada minuto"] -- "x-vigia" --> V
  V -- "Web Push" --> W
  V -- "API de Zernio · solo lectura" --> Z["Zernio<br/>tu WhatsApp"]
  V -- "MCP (OAuth) o API" --> T["Metricool<br/>tus redes sociales"]

• Tus correos nunca se guardan en el servidor. La app y el MCP los piden directamente a Google con tokens que caducan en una hora.

• Los permisos de Google (refresh tokens) viven cifrados en un fichero de tu Drive que solo ve esta app.

• Sin dependencias en el servidor ni en el MCP: es Node 20 puro, y por tanto hay menos que auditar.

Preguntas frecuentes

Contribuir

Los fallos, las ideas y las mejoras son bienvenidos: lee CONTRIBUTING.md. Para un problema de seguridad, usa el aviso privado que explica SECURITY.md.

Historial de estrellas

Licencia

MIT. Úsalo, cámbialo y compártelo libremente.

Buzonero Campillero no está afiliado a Google. Gmail, Google Drive y Google Calendar son marcas de Google LLC.