Repolode
Enviar
ridafkih

ridafkih/keeper.sh

Ferramenta open source para sincronizar calendários, agregando e espelhando eventos entre Google, Outlook, iCloud, Fastmail, CalDAV e ICS, com servidor MCP integrado.

Ver no GitHubSite
Estrelas
1,444
Forks
75
Issues abertas
164
Último commit
ontem

O que é?

O Keeper.sh busca eventos do Google Calendar, Outlook, iCloud, Fastmail, servidores CalDAV e links remotos de iCal ou ICS, e depois os envia para um ou mais calendários de destino, para que os horários ocupados apareçam em todos eles. Google, Outlook, iCloud, Fastmail e CalDAV podem ser fontes ou destinos, enquanto links de iCal e ICS servem apenas como fontes.

O mecanismo de sincronização acompanha quais eventos criou. Assim, quando um evento é excluído na origem, sua cópia no destino é removida na sincronização seguinte, e a limpeza nunca afeta eventos criados diretamente pelo usuário. Os controles de privacidade por fonte podem remover nomes, descrições e locais dos eventos, substituindo os títulos por um modelo com o nome do calendário ou do evento. Google e Outlook usam tokens de sincronização do provedor para atualizações incrementais.

O Keeper.sh também oferece uma REST API em /api/v1, autenticada com tokens de API, um servidor MCP para que agentes de IA possam ler e gerenciar calendários e um feed iCal combinado, ao qual qualquer aplicativo de calendário pode se inscrever. Está disponível como serviço hospedado e como uma stack que você pode hospedar por conta própria, criada com imagens Docker, PostgreSQL e Redis.

Recursos principais

  • 01Sincroniza calendários entre Google Calendar, Outlook, iCloud, Fastmail e CalDAV, como fontes ou destinos
  • 02Busca eventos de links de iCal e ICS
  • 03Sincronização incremental para Google e Outlook usando tokens de sincronização do provedor
  • 04Controles de privacidade por fonte que ocultam títulos, descrições e locais dos eventos
  • 05REST API e servidor MCP para gerenciar calendários programaticamente ou por agentes de IA
  • 06Feed iCal combinado para inscrição em qualquer aplicativo de calendário

Casos de uso

  • Manter calendários profissionais, pessoais e comerciais alinhados para evitar sobreposição de reuniões
  • Compartilhar horários ocupados ou livres de um calendário para outro sem expor detalhes dos eventos
  • Permitir que um agente de IA leia e gerencie calendários por meio do MCP
  • Hospedar por conta própria a agregação de calendários usando PostgreSQL e Redis próprios

Início rápido

  1. 1

    Instale as dependências (requer Bun v1.3.11+ e Docker)

    bun install
  2. 2

    Inicie o ambiente de desenvolvimento (PostgreSQL, Redis, Caddy e todos os serviços)

    bun dev
  3. 3

    Abra https://keeper.localhost no navegador (primeiro, confie na CA raiz local, conforme descrito no README)

Antes de usar

  • A hospedagem própria significa que você mesmo gerencia o servidor, o domínio, as atualizações e os backups.
  • A hospedagem própria exige que você registre seus próprios aplicativos OAuth do Google e da Microsoft.
  • AGPL-3.0 é uma licença copyleft; portanto, versões modificadas que você executar como serviço devem ser compartilhadas sob os mesmos termos.

Em coleções

Servidores MCPApps auto-hospedados

Tópicos

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

Perguntas frequentes

O que é keeper.sh?
Ferramenta open source para sincronizar calendários, agregando e espelhando eventos entre Google, Outlook, iCloud, Fastmail, CalDAV e ICS, com servidor MCP integrado. O Keeper.sh busca eventos do Google Calendar, Outlook, iCloud, Fastmail, servidores CalDAV e links remotos de iCal ou ICS, e depois os envia para um ou mais calendários de destino, para que os horários ocupados apareçam em todos eles. Google, Outlook, iCloud, Fastmail e CalDAV podem ser fontes ou destinos, enquanto links de iCal e ICS servem apenas como fontes.
keeper.sh é gratuito? Qual é a licença?
keeper.sh é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
keeper.sh ainda é mantido?
Manutenção ativa. O último commit de keeper.sh foi em 6 de nov. de 2026.
Para que posso usar keeper.sh?
Manter calendários profissionais, pessoais e comerciais alinhados para evitar sobreposição de reuniões Compartilhar horários ocupados ou livres de um calendário para outro sem expor detalhes dos eventos Permitir que um agente de IA leia e gerencie calendários por meio do MCP Hospedar por conta própria a agregação de calendários usando PostgreSQL e Redis próprios
Como instalar keeper.sh?
Instale as dependências (requer Bun v1.3.11+ e Docker): bun install Inicie o ambiente de desenvolvimento (PostgreSQL, Redis, Caddy e todos os serviços): bun dev Abra https://keeper.localhost no navegador (primeiro, confie na CA raiz local, conforme descrito no README)
Onde consigo keeper.sh?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ridafkih/keeper.sh

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados