Skip to main content
Glama

Fitbit MCP Server

AI용 Fitbit MCP 커넥터

핏빗 API 씨아이 적용 상태 라이센스: MIT npm 버전 npm 다운로드

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. 패키지 디렉토리에

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

Deploy Server
A
security – no known vulnerabilities
-
license - not tested
A
quality - confirmed to work

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이 정의된 도구를 통해 사용자 건강 및 피트니스 데이터를 요청하고 검색할 수 있도록 합니다.

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

      Related MCP Servers

      • -
        security
        -
        license
        -
        quality
        A Model Context Protocol server that allows Claude to interact with Linear's API for managing teams, issues, projects, and cycles.
        Last updated -
        1,454
        2
        MIT License
      • -
        security
        -
        license
        -
        quality
        A 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.
      • -
        security
        -
        license
        -
        quality
        A Model Context Protocol server that enables LLMs like Claude to interact with SQLite and SQL Server databases, allowing for schema inspection and SQL query execution.
        Last updated -
        3,221
        204
        MIT License
        • Linux
        • Apple
      • A
        security
        -
        license
        A
        quality
        A Model Context Protocol server that provides unified access to multiple LLM APIs including ChatGPT, Claude, and DeepSeek, allowing users to call different LLMs from MCP-compatible clients and combine their responses.
        Last updated -
        7
        16
        8
        MIT License

      View all related 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