Cal.com Calendar

Cal.com Calendar MCP Server

Uma implementação de servidor MCP que se integra à API do Cal.com Calendar, fornecendo recursos de agendamento de compromissos.

Recursos

• Adicionar Compromissos: Agende novos compromissos de calendário com detalhes do participante
• Atualizar Compromissos: Modifique detalhes de compromissos existentes, como horário e anotações
• Excluir Compromissos: Cancele e remova compromissos existentes
• Listar Compromissos: Visualize compromissos agendados para intervalos de datas específicos

Ferramentas

• calcom_add_appointment

  • Cria novos compromissos de calendário
  • Entradas:
    • eventTypeId (number): O ID do tipo de evento do Cal.com
    • startTime (string): Horário de início no formato ISO (YYYY-MM-DDTHH:mm:ss.sssZ)
    • endTime (string): Horário de término no formato ISO (YYYY-MM-DDTHH:mm:ss.sssZ)
    • name (string): Nome do participante
    • email (string): E-mail do participante
    • notes (string, opcional): Anotações adicionais para o compromisso

• calcom_update_appointment

  • Atualiza compromissos de calendário existentes
  • Entradas:
    • bookingId (number): O ID da reserva do Cal.com a ser atualizado
    • startTime (string, opcional): Novo horário de início no formato ISO
    • endTime (string, opcional): Novo horário de término no formato ISO
    • notes (string, opcional): Novas anotações para o compromisso

• calcom_delete_appointment

  • Exclui compromissos de calendário existentes
  • Entradas:
    • bookingId (number): O ID da reserva do Cal.com a ser excluído
    • reason (string, opcional): Motivo do cancelamento

• calcom_list_appointments

  • Lista compromissos de calendário em um intervalo de datas
  • Entradas:
    • startDate (string): Data de início no formato YYYY-MM-DD
    • endDate (string): Data de término no formato YYYY-MM-DD

Configuração

Obtendo uma Chave de API

1. Cadastre-se em uma conta do Cal.com
2. Navegue até Configurações > Desenvolvedor > Chaves de API
3. Gere uma nova chave de API com as permissões adequadas

Uso com Claude Desktop

Adicione isso ao seu claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "calcom-calendar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CALCOM_API_KEY",
        "mcp/calcom-calendar"
      ],
      "env": {
        "CALCOM_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "calcom-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-calcom-calendar"
      ],
      "env": {
        "CALCOM_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Build

Build Docker:

docker build -t mcp/calcom-calendar:latest -f Dockerfile .

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você está livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.