Servidor MCP de Garmin

Este servidor de Protocolo de contexto de modelo (MCP) se conecta a Garmin Connect y expone sus datos de estado físico y salud a Claude y otros clientes compatibles con MCP.

Características

Enumere actividades recientes
Obtenga información detallada de la actividad
Acceda a métricas de salud (pasos, frecuencia cardíaca, sueño)
Ver datos de composición corporal

Configuración

Instale los paquetes necesarios en un nuevo entorno:

virtualenv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

Crea un archivo .env en la raíz del proyecto con tus credenciales de Garmin:

GARMIN_EMAIL=your.email@example.com
GARMIN_PASSWORD=your-password

Ejecución del servidor

Con Claude Desktop

Crear una configuración en Claude Desktop:

Edite su archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas: %APPDATA%\Claude\claude_desktop_config.json

Agregue esta configuración de servidor:

{
  "mcpServers": {
    "garmin": {
      "command": "python", // if you created a new environment this should be "<root_folder>/.venv/bin/python"
      "args": ["<path to>/garmin_mcp/garmin_mcp_server.py"]
    }
  }
}

Reemplace la ruta con la ruta absoluta a su archivo de servidor.

Reiniciar Claude Desktop

Con MCP Inspector

Para realizar pruebas, puede utilizar el Inspector MCP:

npx @modelcontextprotocol/inspector python /Users/adomingues/Documents/claude_filesystem/garmin_mcp/garmin_mcp_server.py

Ejemplos de uso

Una vez conectado en Claude, podrás hacer preguntas como:

"Muéstrame mis actividades recientes"
¿Cómo fue mi sueño anoche?
¿Cuántos pasos di ayer?
"Muéstrame los detalles de mi última carrera"

Nota de seguridad

Este servidor requiere tus credenciales de Garmin Connect en el archivo .env . Mantén este archivo seguro y nunca lo envíes a un repositorio.

Solución de problemas

Si tiene problemas para iniciar sesión:

Verifique que sus credenciales en el archivo .env sean correctas
Comprueba si Garmin Connect requiere verificación adicional
Asegúrese de que el paquete GarminConnect esté actualizado

Para otros problemas, consulte los registros de Claude Desktop en:

macOS: ~/Library/Logs/Claude/mcp-server-garmin.log
Ventanas: %APPDATA%\Claude\logs\mcp-server-garmin.log

Garmin MCP Server

Integrations