← garmlink

Conecta Garmin a Gemini

Configura garmlink en

Gemini accede a garmlink mediante el Model Context Protocol (MCP) de tres maneras: como app personalizada en la app de Gemini en la web, con la CLI de Gemini para particulares o en Gemini Enterprise para organizaciones. Esta guía cubre las tres.

Antes de empezar Necesitas una cuenta de garmlink con tu Garmin conectado (hazlo en la pantalla Conexión) y la app de Gemini en la web, la CLI de Gemini en tu equipo o un espacio de Gemini Enterprise.

  1. Conecta tu cuenta de Garmin

    En la pantalla Conexión, inicia sesión en Garmin Connect con tu correo y contraseña (se usan una sola vez y no se guardan), completa el código de verificación si Garmin te lo pide y espera a que el estado pase a Conectado. garmlink empieza enseguida a sincronizar tus actividades, sueño, HRV y métricas de entrenamiento.

Vía A: app de Gemini (web)

Google está desplegando las apps personalizadas poco a poco: por ahora aparecen en cuentas personales de Google en EE. UU., de mayores de 18 años, con Gemini en inglés y Keep Activity activado. ¿Todavía no las ves? La vía B funciona en todas partes.

  1. 2.

    Añade garmlink como app personalizada

    En gemini.google.com, abre Settings, luego Connected Apps y Custom apps. Pega la dirección de garmlink y haz clic en Next:https://api.garmlink.ai/mcp

    Gemini abre la página de inicio de sesión de garmlink: inicia sesión y pulsa Authorize.

  2. 3.

    Llama a garmlink en un chat

    En una conversación, escribe @ y elige garmlink; luego pregunta:
    • «¿Cómo dormí esta semana?»
    • «Resume mis últimas cinco carreras.»
    • «¿Mi carga de entrenamiento sube o baja este mes?»

Vía B: CLI de Gemini (individual)

  1. 4.

    Instala la CLI de Gemini

    Instala la CLI de forma global y ejecútala una vez para que cree su directorio de configuración:
    • npm install -g @google/gemini-cli
    • gemini

    Inicia sesión con tu cuenta de Google cuando te lo pida.

  2. 5.

    Declara garmlink en los ajustes de la CLI

    Abre ~/.gemini/settings.json (créalo si no existe) y declara garmlink como servidor MCP:
    {
  "mcpServers": {
    "garmlink": {
      "httpUrl": "https://api.garmlink.ai/mcp",
      "oauth": { "enabled": true }
    }
  }
}

    No va nada más en ese archivo: ni cabeceras, ni clave de API, ni secreto de cliente. Con OAuth activado, la CLI de Gemini ejecuta ella misma todo el flujo OAuth 2.0.

  3. 6.

    Ejecuta la CLI y aprueba el acceso

    Inicia gemini en una terminal. La primera vez que accede a garmlink abre una ventana del navegador: inicia sesión, aprueba el acceso de solo lectura y la CLI guarda los tokens en local para la próxima vez.

    Después pregunta con lenguaje natural:

    • «¿Cómo dormí esta semana?»
    • «Resume mis últimas cinco carreras.»
    • «¿Mi carga de entrenamiento sube o baja este mes?»

Vía C: Gemini Enterprise (organización)

  1. 7.

    Añade el servidor MCP en Gemini Enterprise

    En Gemini Enterprise, abre Connected apps → Add MCP Server. Rellena los datos del servidor MCP: un nombre, una descripción y la URL de garmlink:https://api.garmlink.ai/mcp

    Solo se admite el transporte StreamableHTTP: los servidores MCP SSE antiguos se rechazan. garmlink usa StreamableHTTP, así que es compatible.

    Icono (opcional)

    PNG, 256×256, ≤ 10 KB. El icono de garmlink lleva su propio fondo, así que se lee bien tanto si la interfaz del asistente es clara como oscura.

    El icono del conector de garmlink
    En una interfaz clara
    El icono del conector de garmlink
    En una interfaz oscura
    Descargar el icono
  2. 8.

    Autentica y define el alcance

    Elige OAuth como método de autenticación y completa el inicio de sesión en garmlink. Luego elige el alcance: publicar la conexión para toda la organización o exigir que cada miembro se autentique con su propia cuenta de garmlink.
Solución de problemas
  • No hay opción Custom apps en la app de Gemini. Tu cuenta aún no tiene apps personalizadas: Google las abre primero a cuentas personales de EE. UU., en inglés. Mientras tanto usa la CLI de Gemini, o Gemini Enterprise si tu organización lo tiene.
  • La CLI no puede autenticarse. Asegúrate de que ~/.gemini/settings.json no lleva ninguna cabecera ni token junto al bloque OAuth: una cabecera Authorization antigua prevalece sobre el flujo OAuth y el servidor responde 401.
  • El servidor es inaccesible. La URL de MCP debe ser accesible por HTTPS desde el equipo donde se ejecuta la CLI (o desde Gemini Enterprise): comprueba que ningún proxy ni firewall la bloquee.
  • Los datos aparecen vacíos o desactualizados. Comprueba en qué punto está la sincronización en la pantalla Conexión.

¿Usas otro asistente? Consulta todas las guías de configuración. ¿Quieres saber qué puede leer garmlink? Consulta la referencia de herramientas. ¿Quieres ver primero respuestas reales? Lee doce ejemplos de una cuenta real.