MCP

caldav-mcp: conecte seus calendários CalDAV a um assistente de IA

Ideal para quem já tem conta em um servidor CalDAV e quer que um assistente de IA consulte e gerencie seus calendários. Exige URL do servidor, usuário e senha; criar, atualizar e excluir gravam diretamente no calendário online, portanto confirme antes de cada ação.

Official source · caldav-mcp

Install

"command": "npx",
      "args": [
        "caldav-mcp"
      ],

Para quem é

  • Para quem já tem uma conta em um servidor CalDAV (próprio ou de um provedor) e quer que um assistente de IA consulte e gerencie os calendários diretamente. O posicionamento oficial é expor operações de calendário como ferramentas para assistentes de IA.
  • As operações cobertas: conectar a um servidor CalDAV, listar calendários, listar os eventos de um calendário em um intervalo de tempo, criar eventos, atualizar eventos e excluir eventos por UID.
  • Os pré-requisitos são claros: é preciso informar a URL do servidor CalDAV, o usuário e a senha por meio das três variáveis de ambiente CALDAV_BASE_URL, CALDAV_USERNAME e CALDAV_PASSWORD; as três são indispensáveis.
  • Não é para: quem não tem um servidor CalDAV ou não quer entregar as credenciais a um processo local. A documentação oficial não informa com quais implementações de servidores CalDAV é compatível, nem se há modo somente leitura; ambos os pontos seguem sem confirmação.

Primeira tentativa em 3 minutos

Caminho principal recomendado: iniciar com npx na configuração mcpServers do cliente MCP; o npx baixa e executa automaticamente o pacote caldav-mcp. Adicione este trecho à configuração:

"command": "npx",
      "args": [
        "caldav-mcp"
      ],

e informe as credenciais na mesma configuração por meio de variáveis de ambiente:

"CALDAV_BASE_URL": "<CalDAV server URL>",
        "CALDAV_USERNAME": "<CalDAV username>",
        "CALDAV_PASSWORD": "<CalDAV password>"

Depois de salvar e reiniciar o cliente, faça primeiro uma chamada de leitura: peça ao assistente de IA que “liste meus calendários”, o que corresponde a List calendars na lista oficial de capacidades. O sinal de sucesso é o assistente devolver a lista de calendários da conta. Esta etapa apenas lê a estrutura do calendário, sem criar ou modificar eventos, mas conecta ao servidor CalDAV com suas credenciais.

Alerta obrigatório: criar, atualizar e excluir são gravações remotas que alteram diretamente o calendário online. Antes de qualquer gravação, peça ao assistente para repetir a operação planejada, o evento alvo e os campos, e execute somente após a sua confirmação.

O projeto também oferece um modo voltado ao desenvolvimento: executar o código TypeScript diretamente em modo watch, carregando as variáveis de ambiente do .env automaticamente; serve para depuração, enquanto o uso diário segue o caminho npx descrito acima.

Casos de uso

Caso 1: confirmar conexão e permissões (List calendars). Situação: as credenciais acabaram de ser configuradas e há dúvida sobre a URL ou a senha. Método: peça ao assistente que “liste meus calendários”, a ação de leitura mais barata para validar as credenciais. Resultado esperado: a lista de calendários da conta CalDAV; se falhar, confira as três variáveis de ambiente e tente de novo.

Caso 2: alterar apenas os campos necessários com update-event. Situação: uma reunião mudou de horário, mas título, local e o restante permanecem. Método: faça o assistente localizar o evento alvo e chamar o update-event fornecendo apenas os campos a alterar; a descrição oficial diz: “Atualiza um evento de calendário existente. Somente os campos fornecidos são alterados.”. Resultado esperado: apenas os campos informados são atualizados, o restante permanece igual. Ponto de confirmação: é uma gravação remota que impacta diretamente o servidor CalDAV; verifique sem falta o evento alvo e os campos a alterar antes de executar.

Limites de uso

  • Natureza leitura/escrita: as capacidades combinam leitura (listar calendários, listar eventos de um período) e escrita (criar, atualizar, excluir por UID); as ferramentas atuam diretamente no calendário online. A exclusão é feita por UID, e a documentação oficial não informa se um evento excluído pode ser recuperado nem oferece caminho de desfazer; seja especialmente rigoroso na etapa de confirmação.
  • Requisitos de credenciais: URL do servidor, usuário e senha devem ser fornecidos por variáveis de ambiente; não está documentado se autenticações alternativas como OAuth ou senhas de aplicativo são aceitas — sem confirmação.
  • Efeitos colaterais e pontos de confirmação: as gravações alteram de fato o calendário no servidor; o update-event muda apenas os campos fornecidos, campos não mencionados ficam intactos.
  • Outros pontos sem confirmação: a lista de softwares de servidor CalDAV compatíveis e os limites de taxa ou de concorrência não são documentados. “Não documentado” descreve apenas o escopo da documentação e não constitui conclusão alguma de segurança.