OneCal Calendar MCP Server

Conecta tus calendarios de Google, Outlook y iCloud a Claude, ChatGPT y cualquier cliente MCP a través de un servidor seguro. Permite que tu asistente de IA lea tu agenda, verifique tu disponibilidad y cree, actualice y elimine eventos.

Ver en onecal.ioPrueba este MCPPatrocinado

Documentación

OneCal expone un servidor de Model Context Protocol (MCP) que permite a clientes de IA como ChatGPT leer y gestionar tus calendarios conectados en tu nombre. Una vez conectado, puedes pedirle a ChatGPT que liste tus calendarios, verifique tu disponibilidad y cree, actualice o elimine eventos de calendario.

En ChatGPT, los conectores MCP personalizados se llaman apps. Conectar OneCal implica alternar entre ChatGPT y OneCal: comienzas creando la app en ChatGPT para obtener su URL de callback, usas esa URL para crear el cliente MCP en OneCal, y luego vuelves a ChatGPT con las credenciales que OneCal te proporciona.

Requisitos previos

Antes de comenzar, asegúrate de tener lo siguiente:

  • Una cuenta de OneCal con una Prueba Gratuita activa o cualquier plan de pago.
  • Al menos un calendario conectado a tu cuenta de OneCal.
  • Ya haber iniciado sesión en tu cuenta de OneCal.
  • Una suscripción de pago de ChatGPT. La creación de apps personalizadas solo está disponible en los planes de pago de ChatGPT, no en el plan gratuito.

Paso 1: Comienza a crear la app en ChatGPT y copia la URL de callback

1. Abre ChatGPT y ve a Configuración > Apps.

2. En la sección Configuración avanzada, haz clic en Crear app.

Grainy Texture

Configuración > Apps > Configuración avanzada > Crear app

3. En el diálogo Nueva app, ingresa un Nombre para la app, por ejemplo: "OneCal MCP".

4. En Conexión, mantén seleccionado URL del servidor e ingresa la URL del servidor MCP de OneCal:

https://mcp-server.onecal.io/mcp

5. Establece Autenticación en OAuth, luego haz clic en Configuración avanzada de OAuth.

Grainy Texture

Ingresa la URL del servidor MCP de OneCal y abre la Configuración avanzada de OAuth

6. En Configuración avanzada de OAuth, establece Método de registro en Cliente OAuth definido por el usuario, luego copia la URL de callback que ChatGPT muestra. La URL de callback es única para esta app, así que cópiala directamente en lugar de escribirla de memoria. La necesitarás en el siguiente paso para crear el cliente MCP en OneCal.

Grainy Texture

Copia la URL de callback desde la configuración avanzada de OAuth de ChatGPT

Mantén esta pestaña de ChatGPT abierta, ya que volverás a ella en el Paso 3.

Paso 2: Crea un cliente MCP en OneCal

1. En una nueva pestaña, navega a https://app.onecal.io/ y abre Configuración > Configuración MCP.

2. Haz clic en el botón Nuevo cliente.

3. Dale al cliente un nombre reconocible, por ejemplo: "ChatGPT". Esto te ayudará a identificar a qué app pertenece el cliente más adelante.

4. Deja habilitada la opción Admite autenticación OAuth con secreto de cliente.

5. Elige los alcances que deseas otorgar. Los alcances controlan lo que ChatGPT puede hacer a través del servidor MCP. Para acceso completo al calendario, habilita Leer tus eventos de calendario y Crear y modificar eventos de calendario. El acceso al perfil, correo electrónico y acceso sin conexión es obligatorio y siempre está incluido. Solo otorga los alcances que realmente necesites.

6. En el campo URI de redirección predeterminada, pega la URL de callback que copiaste desde la Configuración avanzada de OAuth de ChatGPT.

Grainy Texture

Crea el cliente MCP en OneCal y pega la URL de callback de ChatGPT

7. Haz clic en Crear cliente. OneCal generará tus credenciales de cliente, incluidos el ID de cliente, el Secreto de cliente y otros detalles de conexión.

8. Copia y almacena estos valores de forma segura. Trata el Secreto de cliente como una contraseña. Se muestra una sola vez y nunca debe compartirse públicamente.

Paso 3: Finaliza la app en ChatGPT

1. Vuelve a la app de ChatGPT que comenzaste en el Paso 1, en la sección Configuración avanzada de OAuth.

2. Pega el ID de cliente y el Secreto de cliente de OneCal en sus campos correspondientes.

3. Acepta la advertencia del servidor MCP personalizado de ChatGPT marcando Entiendo y quiero continuar, luego haz clic en Crear.

4. ChatGPT muestra un mensaje Agregar "{nombre de la app}" a ChatGPT con un botón Iniciar sesión con "{nombre de la app}", donde {app name} es el nombre que le diste a la app anteriormente. Haz clic en él para iniciar el flujo de OAuth.

5. Serás redirigido a OneCal. Inicia sesión si se te solicita, revisa el acceso que ChatGPT está solicitando y haz clic en Autorizar para otorgar el acceso.

Grainy Texture

Autoriza a ChatGPT para acceder a tu cuenta de OneCal

6. Después de autorizar, ChatGPT redirige de vuelta y marca la app como conectada.

Paso 4: Usa OneCal en ChatGPT

Una vez conectado, puedes invocar la app de OneCal en una conversación escribiendo @ seguido del nombre de la app (por ejemplo, @OneCal MCP) y luego tu solicitud. Por ejemplo, puedes pedirle a ChatGPT que:

  • Liste tus calendarios conectados.
  • Verifique tu disponibilidad para un día o rango de tiempo determinado.
  • Cree, actualice o elimine eventos de calendario.

ChatGPT solo podrá realizar acciones permitidas por los alcances que seleccionaste al crear el cliente.

Solución de problemas

  • La autorización falla o redirige a una página de error: Asegúrate de que la URI de redirección que agregaste en OneCal coincida exactamente con la URL de callback de la Configuración avanzada de OAuth de ChatGPT. Incluso una diferencia de barra diagonal final hará que el flujo falle.
  • La app puede leer pero no crear o editar eventos: Confirma que otorgaste el alcance de escritura del calendario al crear el cliente. Puedes editar los alcances del cliente en Configuración > Configuración MCP.
  • Errores de cliente no válido: Verifica que el ID de cliente y el Secreto de cliente se hayan copiado correctamente, sin espacios adicionales.