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
A
license - permissive license
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
        A
        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 -
        10
        2
        MIT License
      • -
        security
        A
        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.
        Last updated -
        MIT License
        • Apple
      • -
        security
        A
        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 -
        417
        185
        MIT License
        • Linux
        • Apple
      • A
        security
        A
        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
        29
        2
        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