Cal.com MCP

oficial

Conecte clientes de IA ao agendamento do Cal.com através do Model Context Protocol usando o servidor hospedado em mcp.cal.com ou uma instância local.

Ver em cal.com

Documentação

Servidor MCP

Conecte clientes de IA ao agendamento do Cal.com através do Model Context Protocol usando o servidor hospedado em mcp.cal.com ou uma instância local.

O servidor MCP do Cal.com encapsula a API v2 do Cal.com no Model Context Protocol, permitindo que você gerencie reservas, tipos de evento, agendas e muito mais através de linguagem natural em qualquer cliente compatível com MCP.

Servidor hospedado (mcp.cal.com)

A maneira mais rápida de começar é conectar seu cliente MCP diretamente ao mcp.cal.com. O servidor hospedado usa transporte HTTP Streamable com autenticação OAuth 2.1 — seu cliente lida com o fluxo de autorização automaticamente.

Conecte seu cliente

Aponte seu cliente MCP para a URL do servidor hospedado:

https://mcp.cal.com/mcp

Ao conectar pela primeira vez, seu cliente o guiará por um fluxo de autorização OAuth onde você concede ao servidor acesso à sua conta do Cal.com. Nenhuma chave de API é necessária.

Adicione o seguinte ao seu `claude_desktop_config.json`: 
* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```
Abra **Configurações → MCP** e adicione um novo servidor com a URL `https://mcp.cal.com/mcp`, ou adicione-o ao seu `.cursor/mcp.json`: 
```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```
Adicione o servidor às suas configurações de MCP do VS Code: 
```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```

Servidor auto-hospedado (stdio)

Se preferir executar o servidor localmente, você pode usar o transporte stdio com uma chave de API. Isso é útil para desenvolvimento ou quando você deseja controle total sobre o servidor.

Pré-requisitos

Conecte seu cliente

Adicione o seguinte à configuração do seu cliente MCP:

{
  "mcpServers": {
    "calcom": {
      "command": "npx",
      "args": ["@calcom/cal-mcp@latest"],
      "env": {
        "CAL_API_KEY": "cal_live_xxxx"
      }
    }
  }
}

Substitua cal_live_xxxx pela sua chave de API real.

Nunca compartilhe ou faça commit da sua chave de API. Se exposta, rotacione-a imediatamente nas suas [configurações do Cal.com](https://app.cal.com/settings/developer/api-keys).

Ferramentas disponíveis

O servidor MCP expõe 34 ferramentas organizadas por categoria:

Perfil do usuário

FerramentaDescrição
get_meObter seu perfil de usuário autenticado
update_meAtualizar seu perfil de usuário

Tipos de evento

FerramentaDescrição
get_event_typesListar todos os tipos de evento
get_event_typeObter um tipo de evento específico por ID
create_event_typeCriar um novo tipo de evento
update_event_typeAtualizar um tipo de evento
delete_event_typeExcluir um tipo de evento

Reservas

FerramentaDescrição
get_bookingsListar reservas com filtros opcionais
get_bookingObter uma reserva específica por UID
create_bookingCriar uma nova reserva
reschedule_bookingReagendar uma reserva
cancel_bookingCancelar uma reserva
confirm_bookingConfirmar uma reserva pendente
mark_booking_absentMarcar ausência em uma reserva
get_booking_attendeesObter todos os participantes de uma reserva
add_booking_attendeeAdicionar um participante a uma reserva
get_booking_attendeeObter um participante específico

Agendas

FerramentaDescrição
get_schedulesListar todas as agendas
get_scheduleObter uma agenda específica por ID
create_scheduleCriar uma nova agenda
update_scheduleAtualizar uma agenda
delete_scheduleExcluir uma agenda
get_default_scheduleObter sua agenda padrão

Disponibilidade

FerramentaDescrição
get_availabilityObter horários disponíveis
get_busy_timesObter horários ocupados dos calendários

Conferência

FerramentaDescrição
get_conferencing_appsListar aplicativos de conferência

Formulários de roteamento

FerramentaDescrição
calculate_routing_form_slotsCalcular horários com base na resposta do formulário de roteamento

Organizações

FerramentaDescrição
get_org_membershipsObter todas as associações da organização
create_org_membershipCriar uma associação de organização
get_org_membershipObter uma associação de organização
delete_org_membershipExcluir uma associação de organização
get_org_routing_formsObter formulários de roteamento da organização
get_org_routing_form_responsesObter respostas do formulário de roteamento

Exemplos de prompts

Uma vez conectado, você pode interagir com o Cal.com usando linguagem natural:

  • "Quais reservas eu tenho esta semana?"
  • "Crie um tipo de evento de 30 minutos chamado 'Conversa Rápida'"
  • "Cancele minha reunião com o John amanhã"
  • "Mostre meus horários disponíveis para a próxima segunda-feira"
  • "Reagende minha reunião das 14h para quinta-feira às 15h"
  • "Quais tipos de evento eu tenho?"

Recursos relacionados