Agenda con Claude, ChatGPT y Cursor: el servidor MCP de WhenToMeet

No hemos enviado un asistente de IA dentro de WhenToMeet. Ya tienes uno.

Si usas Claude, ChatGPT o Cursor, el asistente por el que estás pagando es más útil que cualquier chatbot que pudiéramos meter en una barra lateral. Lo que le falta es permiso para tocar tu calendario. Eso es lo que el servidor MCP le da.

MCP en un párrafo

MCP — el Model Context Protocol — es una pequeña especificación para exponer herramientas a un cliente LLM. El cliente se conecta a un servidor, lee una lista de tools con entradas tipadas, y las llama cuando la conversación lo necesita. Es el enchufe, no la lámpara. WhenToMeet corre el servidor; tu asistente favorito es el cliente.

El endpoint es POST /api/mcp. Transporte HTTP sin estado. Las mismas API keys que REST v1.

Instalación

En tu cliente MCP — Claude Desktop, ChatGPT con connectors, Cursor o cualquier otro — añades una entrada de servidor que apunte a https://whentomeet.com/api/mcp con tu API key como token Bearer. La forma exacta de la config varía según el cliente; docs.whentomeet.io tiene los snippets copy-paste para los más comunes.

Una vez conectado, el asistente ve siete tools:

• list_polls — tus scheduling polls y direct events
• get_poll — un evento con sus slots y votos de participantes
• create_poll — crear un nuevo scheduling event
• list_bookings — citas reservadas a través de tus booking pages
• list_calendar_events — un feed unificado de todos los calendarios conectados
• check_conflicts — ¿choca este rango horario con algo?
• get_user_profile — tu plan, zona horaria, preferencias

Esa es toda la superficie hoy.

Prompts que realmente funcionan

Los prompts genéricos producen llamadas genéricas. Estos funcionan:

"¿Qué hay en mi calendario el próximo martes entre las 10 y las 16? Usa list_calendar_events con ese rango."

"Quiero un bloque de enfoque de 2 horas mañana por la mañana. Revisa mi calendario con check_conflicts y sugiere tres horas de inicio libres."

"Crea un scheduling poll llamado 'Planificación Q3' con seis slots de una hora entre 2026-05-04 y 2026-05-06, solo en horario laboral."

"Resume mis bookings de los últimos 30 días — quién reservó qué y cuántos no-shows."

"Redacta una agenda para el standup de mañana basada en lo que hay en mi calendario esta semana."

El patrón: nombra el tool si quieres control, describe el resultado si no. Claude y GPT son buenos eligiendo el tool correcto a partir de la descripción.

Lo que aún no puede hacer

La superficie MCP no es todo el producto. A día de hoy, el asistente no puede:

• Votar en la poll de otra persona por ti
• Editar o cancelar un evento existente
• Leer o cambiar los ajustes de una booking page
• Hacer algo que requiera OAuth en un calendario externo en tu nombre — eso pasa una vez en nuestra UI, y después el servidor MCP ve los datos unificados

Son huecos que iremos cerrando según lo que la gente pida realmente. Si el tool que quieres no está, dínoslo.

Rate limits y claves

El servidor MCP usa las mismas claves que REST v1 y los mismos límites por clave. El uso conversacional normal — una docena de tool calls por sesión — está muy por debajo del techo. Si corres un batch job, usa los endpoints REST directamente; para eso están.

El acceso a la API está gated para Pro. Genera una clave en ajustes, pégala en la config de tu cliente MCP, y listo.

Por qué lo hicimos así

Podríamos haber construido un panel de chat dentro de la app. Sería demo-friendly. Pero el asistente que ya usas es mejor, ya está en tu flujo de trabajo y ya tiene contexto que nosotros nunca tendremos. Darle una superficie limpia sobre tu calendario vale más que darte una versión peor de Claude dentro de WhenToMeet.

Los docs completos de setup y la referencia actual de tools están en docs.whentomeet.io.