AI용 Fitbit MCP 커넥터

AI 어시스턴트를 Fitbit 건강 데이터에 연결하세요

AI 비서에게 Fitbit 데이터에 대한 접근 권한을 부여하여 개인 맞춤형 건강 정보, 트렌드 분석 및 자동 추적을 제공하세요. Claude Desktop 및 기타 MCP 호환 AI 도구와 호환됩니다.

그것이 하는 일

🏃 운동 및 활동 - 자세한 운동 기록 및 활동 데이터를 받으세요
😴 수면 분석 - 수면 패턴 및 수면 질 지표 검색
⚖️ 체중 추적 - 시간 경과에 따른 체중 추세 확인
❤️ 심박수 데이터 - 심박수 패턴 및 구역 모니터링
🍎 영양 기록 - 음식 섭취량, 칼로리, 매크로를 검토하세요
👤 프로필 정보 - 기본 Fitbit 프로필 세부 정보에 액세스하세요

AI에게 "이번 주 수면 패턴을 보여줘" 또는 "운동 중 평균 심박수는 얼마야?"와 같이 질문해 보세요.

Related MCP server: Linear MCP Server

빠른 시작

🚀 도구를 바로 테스트해 보시겠습니까?

옵션 1: npm에서 설치(권장)

1. Fitbit API 자격 증명 받기

   • OAuth 2.0으로 앱 만들기 애플리케이션 유형: Personal

   • 콜백 URL 설정: http://localhost:3000/callback

   • 클라이언트 ID 와 클라이언트 비밀번호를 기록해 두세요.

2. 패키지를 전역으로 설치합니다.

지엑스피1

3. Claude Desktop 구성 파일에 다음을 추가합니다.

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

• 구성 파일 위치:

  • 윈도우: %AppData%\Claude\claude_desktop_config.json

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

  • 리눅스: ~/.config/Claude/claude_desktop_config.json

4. Claude Desktop을 재시작하고 Fitbit 데이터에 대해 문의하세요!

옵션 2: 개발 설정

1. Fitbit API 자격 증명 가져오기 (아래 설치 참조)

2. 그런 다음 실행하세요.

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

두 옵션 모두 http://localhost:5173 에서 MCP 검사기를 열어 모든 도구를 대화형으로 테스트하고 OAuth 흐름을 처리할 수 있습니다.

설치

최종 사용자를 위한(npm 패키지)

1. dev.fitbit.com 에서 Fitbit API 자격 증명을 받으세요

   • OAuth 2.0 애플리케이션 유형을 Personal 으로 설정

   • 콜백 URL을 http://localhost:3000/callback 으로 설정합니다.

2. 패키지를 설치하세요:

   npm install -g mcp-fitbit

3. 패키지 디렉토리에 .env 파일을 만듭니다.

   mcp-fitbit 처음 실행하면 .env 파일을 생성할 정확한 위치를 알려줍니다. 파일 형식은 다음과 같습니다.

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

4. .env 파일에 자격 증명을 추가합니다.

   FITBIT_CLIENT_ID=your_client_id_here
   FITBIT_CLIENT_SECRET=your_client_secret_here

5. 서버를 실행합니다:

   mcp-fitbit

개발자를 위한 (소스에서)

1. dev.fitbit.com 에서 Fitbit API 자격 증명을 받으세요

   • OAuth 2.0 애플리케이션 유형을 Personal 으로 설정

   • 콜백 URL을 http://localhost:3000/callback 으로 설정합니다.

2. 복제 및 설정:

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

3. .env 파일을 만듭니다.

   FITBIT_CLIENT_ID=your_client_id_here
   FITBIT_CLIENT_SECRET=your_client_secret_here

4. 서버를 빌드하세요:

   npm run build

사용 가능한 도구

영양 정보: caloriesIn , water , protein , carbs , fat , fiber , sodium

활동 시간 시리즈 리소스: steps , distance , calories , activityCalories , caloriesBMR , tracker/activityCalories , tracker/calories , tracker/distance

클로드 데스크탑

npm 패키지 사용(권장):

claude_desktop_config.json 에 추가:

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

로컬 개발 버전 사용:

claude_desktop_config.json 에 추가:

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

구성 파일 위치:

• 윈도우: %AppData%\Claude\claude_desktop_config.json

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

• 리눅스: ~/.config/Claude/claude_desktop_config.json

첫 번째 실행 승인

AI 비서에게 Fitbit 데이터를 사용하도록 처음 요청할 때:

1. 서버가 브라우저를 http://localhost:3000/auth 로 엽니다.

2. Fitbit에 로그인하고 권한을 부여하세요

3. 성공 페이지로 리디렉션됩니다.

4. 이제 AI가 Fitbit 데이터에 액세스할 수 있습니다!

개발

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

아키텍처: 개선 가능성과 기술적 세부 사항은 TASKS.md를 참조하세요.