Skip to main content
Glama
alerl25
by alerl25

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 para ti, en el ordenador y en el móvil.

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: 28 herramientas para tu agente

Para…

Herramientas

Ver todas las cuentas a la vez

cuentas, buscar_en_todas (bandeja unificada o búsqueda en todas), paquetes, suscripciones, basura_parada, avisos_pendientes, buscar_contacto

Leer

buscar, leer_hilo, descargar_adjunto

Escribir

crear_borrador (nuevo, respuesta o reenvío con adjuntos), enviar, enviar_borrador, listar_borradores, borrar_borrador

Ordenar

modificar_hilos (archivar, leído, destacar, spam, papelera, etiquetas; por ids o por una búsqueda), etiquetas, crear_etiqueta, color_etiqueta

Seguimiento

avisame_si_no_contesta, quitar_aviso

Limpiar

darse_de_baja, bloquear_remitente, filtros, crear_filtro, borrar_filtro

Cuenta

firma, cambiar_firma

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.»

IMPORTANT

Seguro por defecto:

  • Escribe borradores. Enviar, darse de baja y bloquear piden confirmado: true, así que tu agente tiene que preguntarte antes.

  • El MCP no guarda tus permisos de Google: pide a tu instalación tokens de una hora con su propia clave.

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 y unos correos 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.

  • 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.

Avisos y móvil

  • Avisos de correo 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…).

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
  • 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.

Ruta

Qué es

mcp/buzonero-mcp.mjs

El servidor MCP: un solo fichero, sin dependencias, habla MCP por stdio

app/index.html

La app entera: un único HTML con su JavaScript, sin compilación

app/tema.css · app/particulas.js

Diseño, temas (scripts/temas.py) y fondo de partículas en WebGL

api/

Funciones de Vercel: sesión, acceso con Google, tokens, avisos y almacén cifrado

sw.js

Service worker: avisos y globo del icono

AGENTS.md

Las instrucciones que sigue tu agente para instalártelo

scripts/

configurar.mjs (claves), subir-a-vercel.mjs, capturas-demo.mjs e imagenes-readme.mjs

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.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    B
    maintenance
    Enables AI assistants to manage multiple Gmail accounts simultaneously with built-in OAuth authentication, supporting email reading, sending, drafts, labels, and account management.
    60
    71 npm
    4
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Multi-account Gmail integration for AI agents, enabling read, write, archive, label, and auto-unsubscribe operations through the Model Context Protocol.
    46 npm
    16
    MIT
  • F
    license
    A
    quality
    B
    maintenance
    Connects AI assistants to multiple Gmail accounts simultaneously, enabling search, read, draft, send, and reply operations with per-account permission controls.
    54
    -