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.
Open source, criado por Eric Luciano na Mentoria Automações Inteligentes (Expert Integrado).
O servidor se identifica no handshake MCP com uma linha de procedência; para desativar (ex.: white-label), defina EXPERT_NO_PROVENANCE=1 no ambiente.
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.
Related MCP Servers
- Alicense-qualityCmaintenanceEnables Claude to interact with Google Calendar through natural language, providing the ability to view, create, update, and delete calendar events with persistent OAuth2 authentication.12MIT
- Alicense-qualityDmaintenanceEnables Claude to interact with Google Calendar through OAuth authentication, allowing users to list events, create and manage meetings, update or delete calendar entries, and find available time slots using natural language.72MIT
- AlicenseAqualityCmaintenanceEnables interaction with Calendly to manage event types, scheduled events, and invitees. It provides tools for checking user availability and canceling appointments directly through the Calendly API.7MIT
- Flicense-qualityCmaintenanceExposes personal Calendly account as MCP tools, allowing users to manage events, view availability, and handle bookings through natural language.
Related MCP Connectors
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
Calendly MCP Pack — wraps the Calendly API v2 for scheduling data.
Connect Claude to Fathom meeting recordings, transcripts, and summaries
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- 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