Qué necesitas para usar Apple Health en Claude Code con MCP
Una instalación actual de Claude Code, la app de telo en tu iPhone y una sincronización terminada. Claude Code lee lo que el iPhone ya ha enviado a tu cuenta de telo; el comando de abajo no sube nada por sí mismo.
Si ya añadiste telo como conector en Claude en la web e inicias sesión en Claude Code con la misma cuenta de Claude, puede que telo ya aparezca en /mcp. En ese caso puedes saltarte el comando e ir directamente al inicio de sesión.
Añade el servidor MCP remoto
--scope user deja telo disponible en todos los proyectos de este ordenador, lo que encaja con una fuente de datos personal. Sin él, el servidor se añade solo al proyecto actual. Evita --scope project: escribe el servidor en un archivo .mcp.json pensado para versionarse en git y compartirse.
El comando solo guarda la dirección. No entra ningún código de inicio de sesión ni token en un archivo de configuración, y todavía no se lee nada de tu salud.
claude mcp add --transport http --scope user telo https://telo.health/mcpInicia sesión desde Claude Code
- Abre Claude Code y escribe /mcp.
- Elige telo y selecciona la opción de autenticarte. El navegador abre la página de inicio de sesión de telo.
- Inicia sesión con el mismo correo que usas en la app de telo, revisa el acceso solicitado y apruébalo.
- Vuelve a la terminal. telo debería aparecer como conectado en /mcp.
Comprueba que la conexión funciona
- Ejecuta claude mcp list en otra terminal para confirmar que telo está configurado.
- Pide a Claude Code que use telo para enumerar las métricas y los rangos de fechas disponibles.
- Confirma que llama de verdad a una herramienta de telo y devuelve la cobertura real. Detente si dice que el servidor no está disponible o responde sin llamar a ninguna herramienta.
Una primera instrucción para tus registros
Claude Code puede escribir el script, ejecutarlo y enseñarte el gráfico, que es lo que una ventana de chat no hace. Pídele que indique qué fechas leyó antes de fiarte de una tendencia.
Usa telo para leer mi sueño de los últimos 90 días. Guarda un CSV con una fila por noche, dibuja el sueño total con una media móvil de 7 días y enumera las noches sin datos en lugar de rellenarlas.Mantén los registros de salud fuera de tus repositorios
Todo lo que guarda Claude Code acaba en la carpeta donde lo abriste. Haz los análisis de salud en una carpeta privada, no dentro de un repositorio de trabajo, y revisa git status antes de hacer commit.
Los registros que devuelve telo también los procesa Anthropic como parte de la conversación, igual que cualquier otro resultado de una herramienta.
Solución de problemas
Si /mcp muestra telo como fallido o pendiente de autenticación, vuelve a iniciar sesión desde /mcp. Si el navegador no se abre, copia el enlace que imprime Claude Code. Comprueba que la URL es exactamente https://telo.health/mcp.
Si la conexión funciona pero faltan registros, revisa la cuenta y la última sincronización en la app de telo. Iniciar sesión correctamente no significa que el iPhone haya concedido los permisos de la app Salud ni que haya terminado de enviar tu historial.
Preguntas prácticas
¿Claude Code usa la integración de salud de Claude del iPhone?
No. Esa integración es una función de la app de Claude para iPhone, y Claude Code se ejecuta en tu ordenador. Para leer Apple Health en Claude Code necesitas una fuente MCP independiente, como telo.
¿Necesito el comando si ya uso telo en Claude en la web?
Puede que no. Con la misma cuenta de Claude, el conector puede aparecer ya en /mcp. Si aparece, autentícate ahí; añadirlo otra vez desde la terminal crea una segunda entrada para el mismo servidor.
¿Los archivos que crea Claude Code salen de mi ordenador?
Los archivos se quedan en la carpeta donde abriste Claude Code. Lo que sale es lo que envía la conversación: los registros que devuelve telo pasan por Anthropic. Si la carpeta es un repositorio, un commit puede publicar el análisis, así que trabaja en una carpeta privada.
Fuentes y disponibilidad
Los planes, las regiones y las pantallas pueden cambiar. Consulta las fuentes oficiales antes de configurar.
Cómo se preparó esta guía
Preparada con ayuda de IA a partir de la documentación oficial citada y del funcionamiento de telo descrito en el proyecto. Las pantallas y los permisos pueden variar según la cuenta. Esta revisión no incluyó una prueba completa con sesión iniciada en cada asistente.