Garmin Connect China MCP

Un servidor MCP local de solo lectura para una cuenta de Garmin Connect de la región de China. Cada cliente de Garmin está bloqueado a garmin.cn; las lecturas de API van a https://connectapi.garmin.cn y a los hosts correspondientes de SSO/DI-auth de China.

Esto utiliza la API web de consumidor no oficial de Garmin Connect a través de garminconnect. Es adecuado para uso personal privado, puede dejar de funcionar cuando Garmin cambie sus servicios y no es un sustituto de la API de Garmin Health aprobada para productos comerciales.

Requisitos

• Python 3.12+

• uv

• Una cuenta de Garmin Connect China

Related MCP server: health-mcp

Instalación y autenticación

Desde este directorio:

uv sync
uv run garmin-cn-auth

El comando de autenticación solicita correo electrónico, contraseña y MFA directamente en tu terminal. Las contraseñas y los códigos MFA nunca se convierten en argumentos de MCP. Los tokens renovables se almacenan por defecto en ~/.config/garmin-cn-mcp/ con permisos de solo propietario.

Trata ese directorio de tokens como una contraseña. Si es posible que haya sido copiado, elimínalo y revoca el acceso a la cuenta desde la configuración de cuenta/seguridad de Garmin.

Añadir a Codex / escritorio de ChatGPT

Con Codex CLI:

codex mcp add garmin-cn -- \
  uv --directory /absolute/path/to/garmincn-mcp run garmin-cn-mcp

O añade esto a ~/.codex/config.toml:

[mcp_servers.garmin-cn]
command = "uv"
args = [
  "--directory",
  "/absolute/path/to/garmincn-mcp",
  "run",
  "garmin-cn-mcp",
]
startup_timeout_sec = 20
tool_timeout_sec = 60

La aplicación de escritorio de ChatGPT, Codex CLI y la extensión de Codex IDE comparten la configuración de MCP para el mismo host de Codex. En el escritorio de ChatGPT también puedes abrir Configuración → Servidores MCP → Añadir servidor, seleccionar STDIO y usar el mismo comando. Reinicia el cliente después de añadirlo y luego usa /mcp para confirmar que garmin-cn está conectado.

ChatGPT web no lee la configuración local de Codex MCP. El uso web requeriría un MCP/plugin remoto alojado por separado con un diseño de autorización y privacidad multiusuario; eso está intencionalmente fuera de este proyecto.

Herramientas

• get_connection_status

• get_daily_summary

• get_sleep

• get_heart_rate

• get_hrv

• get_training_readiness

• get_morning_training_readiness

• get_body_battery

• list_activities

• get_activity_details

• get_activity_exercise_sets

• get_activity_supplementary

Cada herramienta es de solo lectura y no destructiva. Los rangos de fechas están limitados a 31 días y las listas de actividades a 100 resultados. No se expone ninguna ruta de API cruda ni herramienta de escritura de Garmin.

Ruta personalizada del almacén de tokens

Establece GARMIN_CN_TOKEN_STORE tanto para los procesos de autenticación como para los de MCP, o pasa --token-store a cualquiera de los comandos. Mantén la ruta fuera de un repositorio Git.

Comprobaciones de desarrollo

uv sync --group dev
uv run pytest
uv run ruff check .
uv run mypy

Las pruebas usan proveedores simulados y nunca contactan con Garmin.