Conector Fitbit MCP para IA

Conecte los asistentes de IA a sus datos de salud de Fitbit

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

Qué hace

🏃 Ejercicio y actividades : obtén registros detallados de tus entrenamientos y datos de actividad.
Análisis del sueño : recupera patrones de sueño y métricas de calidad
⚖️ Seguimiento de peso : acceda a las tendencias de peso a lo largo del tiempo
❤️ Datos de frecuencia cardíaca : monitoriza patrones y zonas de frecuencia cardíaca
🍎 Registros de nutrición : revise la ingesta de alimentos, las calorías y los macronutrientes.
👤 Información del perfil : accede a los detalles básicos del perfil de Fitbit

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

Related MCP server: coros-mcp

Inicio rápido

¿Quieres probar las herramientas ahora mismo?

Opción 1: Instalar desde npm (recomendado)

1. Obtener las credenciales de la API de Fitbit

   • Crear una aplicación con OAuth 2.0 Tipo de aplicación: Personal

   • Establecer URL de devolución de llamada: http://localhost:3000/callback

   • Anote su ID de cliente y su secreto de cliente

2. Instalar el paquete globalmente:

npm install -g mcp-fitbit

3. Agregue a su 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:

  • Ventanas: %AppData%\Claude\claude_desktop_config.json

  • macOS: ~/Biblioteca/Soporte de aplicaciones/Claude/claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

4. ¡Reinicia Claude Desktop y pregunta por tus datos de Fitbit!

Opción 2: Configuración del desarrollo

1. Obtenga las credenciales de la API de Fitbit (consulte la Instalación a continuación)

2. 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 MCP en http://localhost:5173 donde puedes probar todas las herramientas de forma interactiva y manejar el flujo OAuth.

Instalación

Para usuarios finales (paquete npm)

1. Obtén las credenciales de la API de Fitbit en dev.fitbit.com

   • Establecer el tipo de aplicación OAuth 2.0 como Personal

   • Establezca la URL de devolución de llamada en http://localhost:3000/callback

2. Instalar el paquete:

   npm install -g mcp-fitbit

3. Cree un archivo .env en el directorio del paquete:

   Al ejecutar mcp-fitbit por primera vez, te indicará exactamente dónde crear el archivo .env . Su aspecto será similar al siguiente:

   C:\Users\YourName\AppData\Roaming\npm\node_modules\mcp-fitbit\.env

4. Agregue sus credenciales al archivo .env :

   FITBIT_CLIENT_ID=your_client_id_here
   FITBIT_CLIENT_SECRET=your_client_secret_here

5. Ejecutar el servidor:

   mcp-fitbit

Para desarrolladores (de la fuente)

1. Obtén las credenciales de la API de Fitbit en dev.fitbit.com

   • Establecer el tipo de aplicación OAuth 2.0 como Personal

   • Establezca la URL de devolución de llamada en http://localhost:3000/callback

2. Clonar y configurar:

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

3. Crear archivo .env :

   FITBIT_CLIENT_ID=your_client_id_here
   FITBIT_CLIENT_SECRET=your_client_secret_here

4. Construir el servidor:

   npm run build

Herramientas disponibles

Recursos nutricionales: caloriesIn , water , protein , carbs , fat , fiber , sodium

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

Escritorio de Claude

Usando el paquete npm (recomendado):

Agregar a claude_desktop_config.json :

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

Usando la versión de desarrollo local:

Agregar a claude_desktop_config.json :

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

Ubicaciones de los archivos de configuración:

• Ventanas: %AppData%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Autorización de primera ejecución

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

1. El servidor abre su navegador en http://localhost:3000/auth

2. Inicia sesión en Fitbit y otorga permisos

3. Serás redirigido a una página de éxito.

4. ¡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: consulte TASKS.md para conocer oportunidades de mejora y detalles técnicos.