AI용 Fitbit MCP 커넥터
AI 어시스턴트를 Fitbit 건강 데이터에 연결하세요
AI 비서에게 Fitbit 데이터에 대한 접근 권한을 부여하여 개인 맞춤형 건강 정보, 트렌드 분석 및 자동 추적을 제공하세요. Claude Desktop 및 기타 MCP 호환 AI 도구와 호환됩니다.
그것이 하는 일
🏃 운동 및 활동 - 자세한 운동 기록 및 활동 데이터를 받으세요
😴 수면 분석 - 수면 패턴 및 수면 질 지표 검색
⚖️ 체중 추적 - 시간 경과에 따른 체중 추세 확인
❤️ 심박수 데이터 - 심박수 패턴 및 구역 모니터링
🍎 영양 기록 - 음식 섭취량, 칼로리, 매크로를 검토하세요
👤 프로필 정보 - 기본 Fitbit 프로필 ���부 정보에 액세스하세요
AI에게 "이번 주 수면 패턴을 보여줘" 또는 "운동 중 평균 심박수는 얼마야?"와 같이 질문해 보세요.
빠른 시작
🚀 도구를 바로 테스트해 보시겠습니까?
옵션 1: npm에서 설치(권장)
- Fitbit API 자격 증명 받기
- OAuth 2.0으로 앱 만들기 애플리케이션 유형:
Personal
- 콜백 URL 설정:
http://localhost:3000/callback
- 클라이언트 ID 와 클라이언트 비밀번호를 기록해 두세요.
- OAuth 2.0으로 앱 만들기 애플리케이션 유형:
- 패키지를 전역으로 설치합니다.
지엑스피1
- Claude Desktop 구성 파일에 다음을 추가합니다.
- 구성 파일 위치:
- 윈도우: %AppData%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- 리눅스: ~/.config/Claude/claude_desktop_config.json
- Claude Desktop을 재시작하고 Fitbit 데이터에 대해 문의하세요!
옵션 2: 개발 설정
- Fitbit API 자격 증명 가져오기 (아래 설치 참조)
- 그런 다음 실행하세요.
두 옵션 모두 http://localhost:5173
에서 MCP 검사기를 열어 모든 도구를 대화형으로 테스트하고 OAuth 흐름을 처리할 수 있습니다.
설치
최종 사용자를 위한(npm 패키지)
- dev.fitbit.com 에서 Fitbit API 자격 증명을 받으세요
- OAuth 2.0 애플리케이션 유형을
Personal
으로 설정 - 콜백 URL을
http://localhost:3000/callback
으로 설정합니다.
- OAuth 2.0 애플리케이션 유형을
- 패키지를 설치하세요:
- 패키지 디렉토리에
.env
파일을 만듭니다.mcp-fitbit
처음 실행하면.env
파일을 생성할 정확한 위치를 알려줍니다. 파일 형식은 다음과 같습니다. .env
파일에 자격 증명을 추가합니다.- 서버를 실행합니다:
개발자를 위한 (소스에서)
- dev.fitbit.com 에서 Fitbit API 자격 증명을 받으세요
- OAuth 2.0 애플리케이션 유형을
Personal
으로 설정 - 콜백 URL을
http://localhost:3000/callback
으로 설정합니다.
- OAuth 2.0 애플리케이션 유형을
- 복제 및 설정:
.env
파일을 만듭니다.- 서버를 빌드하세요:
사용 가능한 도구
도구 | 설명 | 매개변수 |
---|---|---|
get_weight | 기간별 무게 데이터 | period : 1d , 7d , 30d , 3m , 6m , 1y |
get_sleep_by_date_range | 날짜 범위별 수면 기록(최대 100일) | startDate , endDate (YYYY-MM-DD) |
get_exercises | 날짜 이후의 활동/운동 기록 | afterDate (YYYY-MM-DD), limit (1-100) |
get_daily_activity_summary | 목표가 포함된 일일 활동 요약 | date (YYYY-MM-DD) |
get_activity_goals | 사용자의 활동 목표(일일/주간) | period : daily , weekly |
get_activity_timeseries | 활동 시계열 데이터(최대 30일) | resourcePath , startDate , endDate (YYYY-MM-DD) |
get_azm_timeseries | 활성 구역 분 시간 시리즈(최대 1095일) | startDate , endDate (YYYY-MM-DD) |
get_heart_rate | 시간대별 심박수 | period : 1d , 7d , 30d , 1w , 1m , 선택 date |
get_heart_rate_by_date_range | 날짜 범위(최대 1년)별 심박수 | startDate , endDate (YYYY-MM-DD) |
get_food_log | 하루 동안의 완전한 영양 데이터 | date (YYYY-MM-DD 또는 "오늘") |
get_nutrition | 시간 경과에 따른 개별 영양소 | resource , period , 선택 date |
get_nutrition_by_date_range | 날짜 범위별 개별 영양소 | resource , startDate , endDate |
get_profile | 사용자 프로필 정보 | 없음 |
영양 정보: caloriesIn
, water
, protein
, carbs
, fat
, fiber
, sodium
활동 시간 시리즈 리소스: steps
, distance
, calories
, activityCalories
, caloriesBMR
, tracker/activityCalories
, tracker/calories
, tracker/distance
클로드 데스크탑
npm 패키지 사용(권장):
claude_desktop_config.json
에 추가:
로컬 개발 버전 사용:
claude_desktop_config.json
에 추가:
구성 파일 위치:
- 윈도우:
%AppData%\Claude\claude_desktop_config.json
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- 리눅스:
~/.config/Claude/claude_desktop_config.json
첫 번째 실행 승인
AI 비서에게 Fitbit 데이터를 사용하도록 처음 요청할 때:
- 서버가 브라우저를
http://localhost:3000/auth
로 엽니다. - Fitbit에 로그인하고 권한을 부여하세요
- 성공 페이지로 리디렉션됩니다.
- 이제 AI가 Fitbit 데이터에 액세스할 수 있습니다!
개발
아키텍처: 개선 가능성과 기술적 세부 사항은 TASKS.md를 참조하세요.
local-only server
The server can only run on the client's local machine because it depends on local resources.
LLM(예: Claude)과 Fitbit API를 연결하는 모델 컨텍스트 프로토콜 서버로, LLM이 정의된 도구를 통해 사용자 건강 및 피트니스 데이터를 요청하고 검색할 수 있도록 합니다.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server for tracking personal health and well-being, offering tools for workout logging, nutrition management, and daily journaling with AI-assisted analysis integration.Last updated -8Python
- -securityAlicense-qualityA Model Context Protocol server that allows Claude to interact with Linear's API for managing teams, issues, projects, and cycles.Last updated -262TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.Last updated -JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables Claude and other LLMs to make HTTP requests with realistic browser fingerprinting, bypassing common anti-bot measures and interacting with websites more naturally.Last updated -36PythonMIT License