Integraciones · MCP

Tu agente de IA ya sabe cuadrar reuniones.

Añade CalHueco como conector en Claude o ChatGPT, o conéctalo a Claude Code y Cursor, y pídele las reuniones como se las pedirías a una persona. Tu agente ve lo mismo que tú ves en CalHueco: tus contactos y tus reuniones. Nunca tu calendario.

Conectarlo en 1 minuto Ver cómo conectarlo ↓

Qué puede hacer por ti

Lee
ver_contactos
Tus contactos en CalHueco, con apodos y si tienen el calendario conectado.
Lee
ver_reuniones
Tus reuniones, su estado, la propuesta activa y quién ha respondido.
Lee
ver_mi_link
Tu link de invitación, para traer a alguien nuevo.
Hace
crear_reunion
Crea una reunión con tus contactos: CalHueco busca el hueco y lo propone a todos.
Hace
responder_propuesta
Acepta o dice «no me va» a una propuesta en tu nombre.
Hace
cancelar_reunion
Cancela una reunión que organizas (avisa a todos).
Hace
recordar_apodo
Guarda cómo llamas tú a un contacto («Rupo es Ruben»).

Cosas que puedes pedirle

«Búscame un hueco de 45 min con Adam y Laura esta semana para el café»
«¿Qué reuniones tengo pendientes de responder?»
«Acepta la propuesta del kickoff»
«Cancela la reunión de mañana con Mercedes y avísales»
«Dame mi link para invitar a Tomás»

Cómo conectarlo

Dos caminos. En las apps con conectores (Claude, ChatGPT) añades la dirección https://www.calhueco.com/api/mcp e inicias sesión con tu Google de CalHueco: sin claves. En la terminal y los editores usas una clave personal de Ajustes. En los dos casos, antes de crear o cancelar nada tu agente te pedirá permiso.

Claude (claude.ai y Claude Desktop)

Listo

En claude.ai: Ajustes → Conectores → Añadir conector personalizado. Nombre «CalHueco», URL del servidor:

https://www.calhueco.com/api/mcp

Pulsa Añadir y luego Conectar: se abre CalHueco, entras con tu Google si no lo estabas y pulsas Permitir. Claude Desktop y la app del móvil lo heredan de tu cuenta. En el chat, activa el conector y pide «¿qué reuniones tengo en CalHueco?».

ChatGPT

Listo

Ajustes → Conectores → Crear (hace falta el modo desarrollador en Ajustes → Aplicaciones y conectores → Configuración avanzada). Nombre «CalHueco», URL del servidor MCP:

https://www.calhueco.com/api/mcp

Autenticación OAuth sin rellenar nada más: ChatGPT se registra solo. Al crear, te manda a CalHueco a dar permiso. Después, en un chat, Herramientas → el conector CalHueco.

Claude Code

Listo

Crea una clave en Ajustes → Tu agente de IA y, en la terminal, cambiando TU_CLAVE por la tuya:

claude mcp add --transport http calhueco https://www.calhueco.com/api/mcp \
  --header "Authorization: Bearer TU_CLAVE"

Luego, en cualquier sesión: «busca hueco con Adam esta semana».

Cursor

Listo

En .cursor/mcp.json (del proyecto o de tu usuario):

{
  "mcpServers": {
    "calhueco": {
      "url": "https://www.calhueco.com/api/mcp",
      "headers": { "Authorization": "Bearer TU_CLAVE" }
    }
  }
}

Claude Desktop

Listo

En claude_desktop_config.json, a través de mcp-remote (hace de puente hasta que Claude Desktop admita cabeceras directamente):

{
  "mcpServers": {
    "calhueco": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.calhueco.com/api/mcp", "--header", "Authorization: Bearer TU_CLAVE"]
    }
  }
}

Codex (OpenAI)

Listo

En ~/.codex/config.toml, con la clave en una variable de entorno:

[mcp_servers.calhueco]
url = "https://www.calhueco.com/api/mcp"
bearer_token_env_var = "CALHUECO_KEY"

Y en tu shell: export CALHUECO_KEY=TU_CLAVE.

Lo que tu agente no puede hacer

· Ver tu calendario: CalHueco tampoco lo ve. Solo existen tus reuniones y los huecos propuestos.
· Elegir día y hora: CalHueco propone el primer hueco libre para todos, como siempre.
· Reunirse con quien no sea tu contacto, ni ver nada de otras personas.
· Cambiar tu horario, tu plan o borrar tu cuenta: eso solo desde la web.

Tú mandas

· Los conectores (Claude, ChatGPT) entran con tu Google y aparecen en Ajustes → «Conectores autorizados»: revócalos cuando quieras.
· Una clave por agente de terminal (hasta 5), con nombre, para saber cuál es cuál.
· Revócala en Ajustes cuando quieras: deja de valer al instante.
· Guardamos solo su huella, no la clave; en Ajustes ves los primeros caracteres y el último uso.
· Tope de 300 llamadas al día por persona, para que un agente en bucle no se descontrole.
· Crear reuniones cuenta igual que desde la web: 10 confirmadas al mes gratis, sin límite con Pro.

Lo siguiente

Outlook y Microsoft 365 como segundo calendario, link de Zoom o Meet automático, avisos en Slack y webhooks para Zapier y Make. Si necesitas alguno antes, díselo al panel de sugerencias.

Empezar gratis