Repolode
Enviar
ridafkih

ridafkih/keeper.sh

Herramienta de código abierto para sincronizar calendarios que agrega y replica eventos entre Google, Outlook, iCloud, Fastmail, CalDAV e ICS, e incluye un servidor MCP.

Ver en GitHubSitio web
Estrellas
1,445
Forks
76
Issues abiertos
164
Último commit
hace 13 horas

¿Qué es?

Keeper.sh obtiene eventos de Google Calendar, Outlook, iCloud, Fastmail, servidores CalDAV y enlaces remotos de iCal o ICS, y luego los envía a uno o más calendarios de destino para que los bloques de tiempo ocupado aparezcan en todos. Google, Outlook, iCloud, Fastmail y CalDAV pueden funcionar como fuentes o destinos, mientras que los enlaces de iCal e ICS solo sirven como fuentes.

El motor de sincronización registra qué eventos creó, de modo que, si se elimina un evento en el origen, su copia en el destino se elimina en una sincronización posterior. La limpieza nunca afecta a los eventos creados directamente por el usuario. Los controles de privacidad por fuente pueden ocultar los nombres, las descripciones y las ubicaciones de los eventos, y reemplazar los títulos con una plantilla basada en el nombre del calendario o del evento. Google y Outlook usan tokens de sincronización del proveedor para las actualizaciones incrementales.

Keeper.sh también ofrece una API REST en /api/v1, autenticada con tokens de API; un servidor MCP para que los agentes de IA puedan consultar y gestionar calendarios; y un feed combinado de iCal al que se puede suscribir cualquier aplicación de calendario. Está disponible como servicio alojado y como stack autohospedable basado en imágenes de Docker, con PostgreSQL y Redis.

Funciones clave

  • 01Sincroniza calendarios entre Google Calendar, Outlook, iCloud, Fastmail y CalDAV, que pueden actuar como fuentes o destinos
  • 02Obtiene eventos de enlaces de iCal e ICS
  • 03Sincronización incremental para Google y Outlook mediante tokens de sincronización del proveedor
  • 04Controles de privacidad por fuente que ocultan los títulos, las descripciones y las ubicaciones de los eventos
  • 05API REST y servidor MCP para gestionar calendarios mediante programación o desde agentes de IA
  • 06Feed combinado de iCal al que se puede suscribir cualquier aplicación de calendario

Casos de uso

  • Mantener sincronizados los calendarios laborales, personales y de negocios para evitar que se superpongan las reuniones
  • Compartir la disponibilidad entre calendarios sin revelar los detalles de los eventos
  • Permitir que un agente de IA consulte y gestione calendarios mediante MCP
  • Alojar la agregación de calendarios en una infraestructura propia con PostgreSQL y Redis

Inicio rápido

  1. 1

    Instala las dependencias (requiere Bun v1.3.11+ y Docker)

    bun install
  2. 2

    Inicia el entorno de desarrollo (PostgreSQL, Redis, Caddy y todos los servicios)

    bun dev
  3. 3

    Abre https://keeper.localhost en tu navegador (primero, confía en la CA raíz local siguiendo las instrucciones del README)

Antes de usarlo

  • El autoalojamiento implica que tú te encargas del servidor, el dominio, las actualizaciones y las copias de seguridad.
  • El autoalojamiento requiere registrar tus propias aplicaciones OAuth de Google y Microsoft.
  • AGPL-3.0 es una licencia copyleft, por lo que las versiones modificadas que ejecutes como servicio deben compartirse bajo las mismas condiciones.

En colecciones

Servidores MCPApps autoalojadas

Temas

#calendar#calendar-sync#caldav#ical#mcp#self-hosted#google-calendar#typescript#bun#icloud

Preguntas frecuentes

¿Qué es keeper.sh?
Herramienta de código abierto para sincronizar calendarios que agrega y replica eventos entre Google, Outlook, iCloud, Fastmail, CalDAV e ICS, e incluye un servidor MCP. Keeper.sh obtiene eventos de Google Calendar, Outlook, iCloud, Fastmail, servidores CalDAV y enlaces remotos de iCal o ICS, y luego los envía a uno o más calendarios de destino para que los bloques de tiempo ocupado aparezcan en todos. Google, Outlook, iCloud, Fastmail y CalDAV pueden funcionar como fuentes o destinos, mientras que los enlaces de iCal e ICS solo sirven como fuentes.
¿keeper.sh es gratuito? ¿Qué licencia tiene?
keeper.sh es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿keeper.sh sigue mantenido?
Mantenimiento activo. El último commit de keeper.sh fue el 7 nov 2026.
¿Para qué puedo usar keeper.sh?
Mantener sincronizados los calendarios laborales, personales y de negocios para evitar que se superpongan las reuniones Compartir la disponibilidad entre calendarios sin revelar los detalles de los eventos Permitir que un agente de IA consulte y gestione calendarios mediante MCP Alojar la agregación de calendarios en una infraestructura propia con PostgreSQL y Redis
¿Cómo se instala keeper.sh?
Instala las dependencias (requiere Bun v1.3.11+ y Docker): bun install Inicia el entorno de desarrollo (PostgreSQL, Redis, Caddy y todos los servicios): bun dev Abre https://keeper.localhost en tu navegador (primero, confía en la CA raíz local siguiendo las instrucciones del README)
¿Dónde consigo keeper.sh?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ridafkih/keeper.sh

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados