Fitbit

Accede a tus datos de salud y fitness de Fitbit para obtener información personalizada.

Documentación

Conector MCP de Fitbit para IA

Conecta asistentes de IA a tus datos de salud de Fitbit

Dale a tu asistente de IA acceso a tus datos de Fitbit para obtener información de salud personalizada, análisis de tendencias y seguimiento automatizado. Funciona con Claude Desktop y otras herramientas de IA compatibles con MCP.

Qué hace

🏃 Ejercicio y Actividades - Obtén registros detallados de entrenamientos y datos de actividad
😴 Análisis del Sueño - Recupera patrones de sueño y métricas de calidad
⚖️ Seguimiento de Peso - Accede a tendencias de peso a lo largo del tiempo
❤️ Datos de Frecuencia Cardíaca - Monitorea patrones y zonas de frecuencia cardíaca
🍎 Registros de Nutrición - Revisa ingesta de alimentos, calorías y macronutrientes
👤 Información del Perfil - Accede a detalles básicos del perfil de Fitbit

Pregúntale a tu IA cosas como: "Muéstrame mis patrones de sueño esta semana" o "¿Cuál es mi frecuencia cardíaca promedio durante los entrenamientos?"

Inicio Rápido

🚀 ¿Quieres probar las herramientas de inmediato?

Opción 1: Instalar desde npm (Recomendado)

Obtén credenciales de la API de Fitbit
- Crea una aplicación con Tipo de Aplicación OAuth 2.0: Personal
- Configura la URL de Devolución de Llamada: http://localhost:3000/callback
- Anota tu ID de Cliente y Secreto de Cliente
Instala el paquete globalmente:

npm install -g mcp-fitbit

Agrégalo a tu archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "fitbit": {
      "command": "mcp-fitbit",
      "args": [],
      "env": {
        "FITBIT_CLIENT_ID": "your_client_id_here",
        "FITBIT_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

Ubicación del archivo de configuración:
- Windows: %AppData%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json

Reinicia Claude Desktop y pregunta sobre tus datos de Fitbit.

Opción 2: Configuración de Desarrollo

Obtén credenciales de la API de Fitbit (consulta Instalación a continuación)
Luego ejecuta:

git clone https://github.com/TheDigitalNinja/mcp-fitbit
cd mcp-fitbit
npm install
# Create .env with your Fitbit credentials
npm run dev

Ambas opciones abren el Inspector de MCP en http://localhost:5173 donde puedes probar todas las herramientas de forma interactiva y manejar el flujo de OAuth.

Instalación

Para Usuarios Finales (paquete npm)

Obtén credenciales de la API de Fitbit en dev.fitbit.com
- Configura Tipo de Aplicación OAuth 2.0 a Personal
- Configura URL de Devolución de Llamada a http://localhost:3000/callback
Instala el paquete:
```
npm install -g mcp-fitbit
```
Crea el archivo .env en el directorio del paquete:

Cuando ejecutes mcp-fitbit por primera vez, te dirá exactamente dónde crear el archivo .env. Se verá algo así:
```
C:\Users\YourName\AppData\Roaming\npm\node_modules\mcp-fitbit\.env
```

Agrega tus credenciales al archivo .env:

FITBIT_CLIENT_ID=your_client_id_here
FITBIT_CLIENT_SECRET=your_client_secret_here

Ejecuta el servidor:
```
mcp-fitbit
```

Para Desarrolladores (desde el código fuente)

Obtén credenciales de la API de Fitbit en dev.fitbit.com
- Configura Tipo de Aplicación OAuth 2.0 a Personal
- Configura URL de Devolución de Llamada a http://localhost:3000/callback

Clona y configura:

git clone https://github.com/TheDigitalNinja/mcp-fitbit
cd mcp-fitbit
npm install

Crea el archivo .env:

FITBIT_CLIENT_ID=your_client_id_here
FITBIT_CLIENT_SECRET=your_client_secret_here

Compila el servidor:
```
npm run build
```

Herramientas Disponibles

Herramienta	Descripción	Parámetros
`get_weight`	Datos de peso en períodos de tiempo	`period`: `1d`, `7d`, `30d`, `3m`, `6m`, `1y`
`get_sleep_by_date_range`	Registros de sueño para rango de fechas (máx. 100 días)	`startDate`, `endDate` (AAAA-MM-DD)
`get_exercises`	Registros de actividad/ejercicio después de una fecha	`afterDate` (AAAA-MM-DD), `limit` (1-100)
`get_daily_activity_summary`	Resumen de actividad diaria con objetivos	`date` (AAAA-MM-DD)
`get_activity_goals`	Objetivos de actividad del usuario (diarios/semanales)	`period`: `daily`, `weekly`
`get_activity_timeseries`	Datos de series temporales de actividad (máx. 30 días)	`resourcePath`, `startDate`, `endDate` (AAAA-MM-DD)
`get_azm_timeseries`	Series temporales de Minutos en Zona Activa (máx. 1095 días)	`startDate`, `endDate` (AAAA-MM-DD)
`get_heart_rate`	Frecuencia cardíaca para un período de tiempo	`period`: `1d`, `7d`, `30d`, `1w`, `1m`, opcional `date`
`get_heart_rate_by_date_range`	Frecuencia cardíaca para rango de fechas (máx. 1 año)	`startDate`, `endDate` (AAAA-MM-DD)
`get_food_log`	Datos completos de nutrición para un día	`date` (AAAA-MM-DD o "hoy")
`get_nutrition`	Nutriente individual a lo largo del tiempo	`resource`, `period`, opcional `date`
`get_nutrition_by_date_range`	Nutriente individual para rango de fechas	`resource`, `startDate`, `endDate`
`get_profile`	Información del perfil del usuario	Ninguno

Recursos de nutrición: caloriesIn, water, protein, carbs, fat, fiber, sodium

Recursos de series temporales de actividad: steps, distance, calories, activityCalories, caloriesBMR, tracker/activityCalories, tracker/calories, tracker/distance

Claude Desktop

Usando el paquete npm (recomendado):

Agrega a claude_desktop_config.json:

{
  "mcpServers": {
    "fitbit": {
      "command": "mcp-fitbit",
      "args": []
    }
  }
}

Usando la versión de desarrollo local:

Agrega a claude_desktop_config.json:

{
  "mcpServers": {
    "fitbit": {
      "command": "node",
      "args": ["C:\\path\\to\\mcp-fitbit\\build\\index.js"]
    }
  }
}

Ubicaciones del archivo de configuración:

Windows: %AppData%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Autorización en el Primer Uso

Cuando le pidas por primera vez a tu asistente de IA que use datos de Fitbit:

El servidor abre tu navegador en http://localhost:3000/auth
Inicia sesión en Fitbit y otorga permisos
Serás redirigido a una página de éxito
¡Tu IA ahora puede acceder a tus datos de Fitbit!

Desarrollo

npm run lint          # Check code quality
npm run format        # Fix formatting
npm run build         # Compile TypeScript
npm run dev           # Run with MCP inspector

Arquitectura: Consulta TASKS.md para oportunidades de mejora y detalles técnicos.