calendly-mcp
This server integrates with the Calendly API v2, enabling Claude to manage scheduling without going through Calendly's public forms.
List event types: Retrieve all active event types, including URI, slug, duration, public URL, and form questions.
Check available slots: Find available time slots for a specific event type within a date range (max 7 days), returned in UTC.
Schedule a meeting: Book a meeting for a guest by providing their name, email, event type URI, and preferred slot. Supports additional form fields (WhatsApp, company, notes) and falls back to a pre-filled URL if direct API scheduling fails.
Cancel an event: Cancel a scheduled event by its UUID, with an optional cancellation reason.
Get event details: Fetch full details of a scheduled event, including status, Zoom link, and invitee/guest data.
Create single-use scheduling link: Generate a one-time booking link for an existing event type.
Create one-off meeting link: Create a custom ad-hoc meeting with a specified name, duration (15/30/60/90 min), and custom dates, providing a single-use link.
Allows managing Calendly events: listing event types and available slots, scheduling and canceling events, and retrieving event details including Zoom links and guest info.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@calendly-mcpschedule a 30-minute call with Bob next Monday at 10 AM"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
calendly-mcp
MCP server para integração com Calendly API v2. Permite que qualquer instância do Claude agende, consulte e cancele reuniões no Calendly — e gere links de agendamento single-use — sem passar pelo formulário público.
→ Como funciona o Calendly MCP — a página do projeto, com o sistema explicado visualmente.
Tools disponíveis
Tool | Descrição |
| Lista tipos de evento ativos, com URI, slug, duração, URL pública e perguntas do formulário |
| Horários disponíveis em um intervalo de datas (máx. 7 dias), em UTC e horário de Brasília |
| Agenda uma reunião para um convidado via Scheduling API |
| Cancela um evento pelo UUID, com motivo registrado |
| Detalhes completos de um evento: status, link Zoom e dados dos convidados |
| Link de agendamento single-use para um tipo de evento existente |
| Reunião avulsa com nome, duração (15/30/60/90 min) e datas customizadas + link single-use |
Sobre calendly_schedule
A ferramenta agenda direto pela Scheduling API do Calendly (POST /invitees), preenchendo os campos do formulário (WhatsApp, empresa, observações). Se a API recusar o agendamento direto, retorna uma URL pré-preenchida com todos os dados do convidado — abra no navegador (ou envie ao convidado) e confirme em um clique.
Related MCP server: Google Calendar MCP Server
Instalação
Pré-requisitos
Claude Code instalado
Node.js 18+ e git
Conta Calendly Standard ou superior (Standard já libera a API v2)
Setup assistido (recomendado)
Copie o prompt abaixo e cole em uma sessão do Claude Code. Ele conduz o processo inteiro — inclusive a geração do seu Personal Access Token no Calendly, navegando pelo browser por você (você só faz o login).
Instale e configure o Calendly MCP (https://github.com/ericlucianoferreira/calendly-mcp) nesta máquina, conduzindo o processo inteiro comigo, etapa por etapa. Regras: nunca me peça senha ou código de verificação no chat; segredos só podem existir em arquivo de configuração local ou variável de ambiente, nunca no chat nem em commit; não declare nada pronto sem validar com uma chamada real.
1. PRÉ-REQUISITOS
- Verifique Node.js 18+ (node --version) e git. Se faltar algo, me oriente a instalar antes de continuar.
- Clone https://github.com/ericlucianoferreira/calendly-mcp.git em uma pasta local definitiva (fora de diretórios temporários), rode npm install e guarde o caminho absoluto do index.js.
- Confirme comigo que minha conta Calendly é Standard ou superior (plano que libera a API v2).
2. TOKEN DO CALENDLY (etapa de navegador)
O servidor autentica com um Personal Access Token, gerado em: calendly.com → Integrations & apps → API & webhooks → Personal access tokens (URL direta: https://calendly.com/integrations/api_webhooks).
Antes de me mandar fazer isso manualmente, pergunte com botões (AskUserQuestion): "Essa etapa é no navegador. Quer que eu faça pra você?" com estas opções:
a) "Faz pra mim (Playwright)" — opção DEFAULT. Se o Playwright MCP não estiver disponível, instale com: claude mcp add playwright -- npx -y @playwright/mcp@latest — e me avise se for preciso reiniciar a sessão pra ele conectar. Depois: abra https://calendly.com/login, espere EU fazer o login sozinho, navegue até Personal access tokens, gere um token com o nome "claude-mcp" e copie o valor exibido na tela direto pra configuração do passo 3 — sem repetir o valor no chat.
b) "Faz pra mim (Chrome)" — se eu já uso a extensão Claude in Chrome, siga o mesmo roteiro usando meu Chrome, que já está logado.
c) "Prefiro fazer manualmente" — me passe o passo a passo numerado e prepare a configuração do passo 3 com o valor vazio, me apontando o arquivo e o campo exatos onde devo colar o token (não pedir pra colar no chat).
3. REGISTRO NO CLAUDE CODE
Registre o servidor com a env var correta. Preferência: escreva a configuração direto no arquivo (o token não passa pelo chat) — entrada "calendly" em mcpServers no ~/.claude.json (ou .mcp.json do projeto), com command "node", args ["<caminho-absoluto>/index.js"] e env {"CALENDLY_TOKEN": "<token>"}. Alternativa por CLI: claude mcp add calendly --env CALENDLY_TOKEN=<token> -- node <caminho-absoluto>/index.js. Me explique onde a configuração ficou salva.
4. VALIDAÇÃO REAL (antes de declarar pronto)
Valide o token com uma chamada real à API v2, lendo o valor do arquivo de configuração sem nunca imprimi-lo: liste os tipos de evento (GET https://api.calendly.com/event_types) e me mostre só nomes e durações. Se vier 401, o token está errado — volte à etapa 2.
5. TESTE E2E E RESUMO
Me peça pra reiniciar o Claude Code (pra o MCP conectar) e, na nova sessão, rode o teste de ponta a ponta: calendly_list_event_types e depois calendly_list_available_slots de um tipo de evento real nos próximos 7 dias. Termine com um resumo: o que foi instalado, onde o token está salvo, quais as 7 tools disponíveis e um exemplo de pedido que já posso fazer ("gera um link de 30 minutos pra semana que vem").Durante a etapa de navegador, o login é sempre seu: o Claude abre a página e espera você entrar na conta. O token vai direto para a configuração local da sua máquina.
Setup manual (resumo)
Gere um Personal Access Token: calendly.com/integrations/api_webhooks → Personal access tokens → Generate new token (nome sugerido:
claude-mcp; o valor é exibido uma única vez).Clone e instale:
git clone https://github.com/ericlucianoferreira/calendly-mcp.git cd calendly-mcp npm installRegistre no Claude Code (substitua o caminho e o token):
claude mcp add calendly --env CALENDLY_TOKEN=<seu-token> -- node /caminho/absoluto/calendly-mcp/index.jsOu adicione no
~/.claude.json(dentro demcpServers):"calendly": { "command": "node", "args": ["/caminho/absoluto/calendly-mcp/index.js"], "env": { "CALENDLY_TOKEN": "<seu-token>" } }Reinicie o Claude Code e valide:
use calendly_list_event_typesDeve retornar a lista de tipos de evento ativos da sua conta.
Variáveis de ambiente
Variável | Obrigatória | Descrição |
| Sim | Personal Access Token do Calendly |
Atualização
cd calendly-mcp
git pullReinicie o Claude Code em seguida para reconectar o MCP.
Segurança
O token fica somente na configuração local (
~/.claude.json/.mcp.json) ou em variável de ambiente — nunca em commit, chat ou log.Se o valor vazar em texto plano, revogue o token no Calendly e gere outro.
Licença
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ericlucianoferreira/calendly-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server