Fitbit

Acesse seus dados de saúde e condicionamento físico do Fitbit para obter insights personalizados.

Documentação

Conector MCP Fitbit para IA

Conecte assistentes de IA aos seus dados de saúde do Fitbit

Dê ao seu assistente de IA acesso aos seus dados do Fitbit para obter insights de saúde personalizados, análise de tendências e monitoramento automatizado. Funciona com Claude Desktop e outras ferramentas de IA compatíveis com MCP.

O que ele faz

🏃 Exercícios e Atividades - Obtenha registros detalhados de treinos e dados de atividades
😴 Análise do Sono - Recupere padrões de sono e métricas de qualidade
⚖️ Acompanhamento de Peso - Acesse tendências de peso ao longo do tempo
❤️ Dados de Frequência Cardíaca - Monitore padrões e zonas de frequência cardíaca
🍎 Registros de Nutrição - Revise ingestão de alimentos, calorias e macronutrientes
👤 Informações do Perfil - Acesse detalhes básicos do perfil do Fitbit

Pergunte à sua IA coisas como: "Mostre-me meus padrões de sono desta semana" ou "Qual é minha frequência cardíaca média durante os treinos?"

Início Rápido

🚀 Quer testar as ferramentas agora mesmo?

Opção 1: Instalar via npm (Recomendado)

Obtenha credenciais da API do Fitbit
- Crie um aplicativo com Tipo de Aplicação OAuth 2.0: Personal
- Defina a URL de Callback: http://localhost:3000/callback
- Anote seu Client ID e Client Secret
Instale o pacote globalmente:

npm install -g mcp-fitbit

Adicione ao arquivo de configuração do Claude Desktop:

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

Localização do arquivo de configuração:
- Windows: %AppData%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json

Reinicie o Claude Desktop e pergunte sobre seus dados do Fitbit!

Opção 2: Configuração de Desenvolvimento

Obtenha credenciais da API do Fitbit (veja Instalação abaixo)
Depois execute:

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

Ambas as opções abrem o MCP Inspector em http://localhost:5173 onde você pode testar todas as ferramentas interativamente e lidar com o fluxo OAuth.

Instalação

Para Usuários Finais (pacote npm)

Obtenha credenciais da API do Fitbit em dev.fitbit.com
- Defina Tipo de Aplicação OAuth 2.0 como Personal
- Defina URL de Callback como http://localhost:3000/callback
Instale o pacote:
```
npm install -g mcp-fitbit
```
Crie o arquivo .env no diretório do pacote:

Quando você executar mcp-fitbit pela primeira vez, ele informará exatamente onde criar o arquivo .env. Será algo como:
```
C:\Users\YourName\AppData\Roaming\npm\node_modules\mcp-fitbit\.env
```

Adicione suas credenciais ao arquivo .env:

FITBIT_CLIENT_ID=your_client_id_here
FITBIT_CLIENT_SECRET=your_client_secret_here

Execute o servidor:
```
mcp-fitbit
```

Para Desenvolvedores (a partir do código-fonte)

Obtenha credenciais da API do Fitbit em dev.fitbit.com
- Defina Tipo de Aplicação OAuth 2.0 como Personal
- Defina URL de Callback como http://localhost:3000/callback

Clone e configure:

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

Crie o arquivo .env:

FITBIT_CLIENT_ID=your_client_id_here
FITBIT_CLIENT_SECRET=your_client_secret_here

Compile o servidor:
```
npm run build
```

Ferramentas Disponíveis

Ferramenta	Descrição	Parâmetros
`get_weight`	Dados de peso ao longo de períodos	`period`: `1d`, `7d`, `30d`, `3m`, `6m`, `1y`
`get_sleep_by_date_range`	Registros de sono para intervalo de datas (máx. 100 dias)	`startDate`, `endDate` (AAAA-MM-DD)
`get_exercises`	Registros de atividades/exercícios após data	`afterDate` (AAAA-MM-DD), `limit` (1-100)
`get_daily_activity_summary`	Resumo diário de atividades com metas	`date` (AAAA-MM-DD)
`get_activity_goals`	Metas de atividades do usuário (diárias/semanais)	`period`: `daily`, `weekly`
`get_activity_timeseries`	Dados de séries temporais de atividades (máx. 30 dias)	`resourcePath`, `startDate`, `endDate` (AAAA-MM-DD)
`get_azm_timeseries`	Séries temporais de Minutos de Zona Ativa (máx. 1095 dias)	`startDate`, `endDate` (AAAA-MM-DD)
`get_heart_rate`	Frequência cardíaca para período	`period`: `1d`, `7d`, `30d`, `1w`, `1m`, opcional `date`
`get_heart_rate_by_date_range`	Frequência cardíaca para intervalo de datas (máx. 1 ano)	`startDate`, `endDate` (AAAA-MM-DD)
`get_food_log`	Dados completos de nutrição para um dia	`date` (AAAA-MM-DD ou "hoje")
`get_nutrition`	Nutriente individual ao longo do tempo	`resource`, `period`, opcional `date`
`get_nutrition_by_date_range`	Nutriente individual para intervalo de datas	`resource`, `startDate`, `endDate`
`get_profile`	Informações do perfil do usuário	Nenhum

Recursos de nutrição: caloriesIn, water, protein, carbs, fat, fiber, sodium

Recursos de séries temporais de atividades: steps, distance, calories, activityCalories, caloriesBMR, tracker/activityCalories, tracker/calories, tracker/distance

Claude Desktop

Usando pacote npm (recomendado):

Adicione ao claude_desktop_config.json:

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

Usando versão de desenvolvimento local:

Adicione ao claude_desktop_config.json:

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

Localizações do arquivo de configuração:

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

Autorização na Primeira Execução

Quando você pedir pela primeira vez ao seu assistente de IA para usar dados do Fitbit:

O servidor abre seu navegador em http://localhost:3000/auth
Faça login no Fitbit e conceda permissões
Você será redirecionado para uma página de sucesso
Sua IA agora pode acessar seus dados do Fitbit!

Desenvolvimento

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

Arquitetura: Veja TASKS.md para oportunidades de melhoria e detalhes técnicos.