Skip to main content
Glama
deenesjakoruzh

Fitbit MCP Server

by TheDigitalNinja
npmGitHub
TypeScript
MIT License
100
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

AI용 Fitbit MCP 커넥터

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

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

그것이 하는 일

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

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

빠른 시작

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

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

  1. Fitbit API 자격 증명 받기
    • OAuth 2.0으로 앱 만들기 애플리케이션 유형: Personal
    • 콜백 URL 설정: http://localhost:3000/callback
    • 클라이언트 ID 와 클라이언트 비밀번호를 기록해 두세요.
  2. 패키지를 전역으로 설치합니다.

지엑스피1

  1. 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
  1. 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

사용 가능한 도구

도구설명매개변수
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 에 추가:

{ "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를 참조하세요.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

LLM(예: Claude)과 Fitbit API를 연결하는 모델 컨텍스트 프로토콜 서버로, LLM이 정의된 도구를 통해 사용자 건강 및 피트니스 데이터를 요청하고 검색할 수 있도록 합니다.

  1. 그것이 하는 일
    1. 빠른 시작
      1. 옵션 1: npm에서 설치(권장)
      2. 옵션 2: 개발 설정
    2. 설치
      1. 최종 사용자를 위한(npm 패키지)
      2. 개발자를 위한 (소스에서)
    3. 사용 가능한 도구
      1. 클로드 데스크탑
      2. 첫 번째 실행 승인
    4. 개발

      Related MCP Servers

      • Personal MCP Server

        evangstav
        -
        security
        F
        license
        -
        quality
        A 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 -
        2
        Python

      • Senechal MCP Server

        mattjoyce
        -
        security
        A
        license
        -
        quality
        A Model Context Protocol server that provides health data from the Senechal API to LLM applications, enabling AI assistants to access, analyze, and respond to personal health information.
        Last updated -
        Python
        GPL 3.0
        • Linux
        • Apple

      • Whoop MCP Server

        ctvidic
        -
        security
        F
        license
        -
        quality
        A Model Context Protocol server that provides language models with access to personal Whoop fitness data, allowing queries for cycles, recovery, strain, and workout information from the Whoop API.
        Last updated -
        2
        Python
        • Apple

      • Math-MCP

        EthanHenrickson
        A
        security
        A
        license
        A
        quality
        A Model Context Protocol server that provides basic mathematical and statistical functions to LLMs, enabling them to perform accurate numerical calculations through a simple API.
        Last updated -
        13
        13
        TypeScript
        MIT License

      View all related MCP servers

      New MCP Servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/TheDigitalNinja/mcp-fitbit'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server