How to Use the Fitbit MCP in Claude Code

Q: Can I run a cron job to export Fitbit sleep data using Claude Code?

Yes. Claude Code uses getsleeptimeseries to pull your sleep logs. You can write a shell script that runs this command daily and saves the JSON output to your local backup folder.

Q: How do I install this Fitbit MCP Server inside Claude Code?

Run claude mcp add with the HTTP transport flags, specifying the server URL. Claude Code will save this to your local config file and instantly register the MCP Server tools.

Q: Can Claude Code fetch my VO2 Max from Fitbit?

Yes. Claude Code calls getcardiofitnessscore to retrieve your current VO2 Max and percentile rankings. It prints this data directly to your terminal screen.

Q: How does Claude Code protect my Fitbit biometric credentials?

Your sensitive health data, such as oxygen saturation from getspo2 and breathing rates from getbreathingrate, is protected using Vinkius's token system. Claude Code only receives the final API response, keeping your raw Fitbit credentials private.

Pipe your Fitbit heart rate, sleep, and activity metrics directly into Claude Code for headless terminal analysis and shell scripts.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Fitbit MCP to Claude Code

Create your Vinkius account to connect Fitbit to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Fitbit with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pipe health metrics to shell scripts in Claude Code

The `get_heart_timeseries` tool outputs resting heart rate and daily zones directly to your terminal. Claude Code lets you query these metrics headlessly, making it easy to pipe the raw output into local grep or awk scripts. You do not need a browser to check your cardiovascular trends. Claude Code runs the command, fetches the heart rate zones, and formats the output as clean JSON that you can redirect into other terminal utilities.

Automate daily sleep audits with Claude Code

The `get_sleep_timeseries` tool retrieves historical sleep logs from the command line. Claude Code parses this data to calculate your average sleep efficiency and deep sleep duration over the last month. You can trigger these audits directly from your terminal session. Claude Code runs `get_sleep_date` to extract specific nightly details, allowing you to run quick shell commands to verify your recovery trends.

Run terminal-based fitness tracking with Claude Code MCP Server

This Fitbit MCP Server exposes `get_activities_date` to pull down your daily step counts, active minutes, and calories burned. Claude Code allows you to query these metrics using simple terminal commands. You can also monitor your physical condition using `get_breathing_rate` and `get_spo2` directly from the CLI. Claude Code prints these biometric stats as plain text, keeping your workflow entirely inside the terminal.

Setup guide

Set up Fitbit MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see fitbit-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Fitbit transactions." It will automatically discover and invoke the available Fitbit tools.

Terminal

claude mcp add --transport http fitbit-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Fitbit MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "fitbit-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Fitbit. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Fitbit now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Fitbit MCP in Claude Code

Yes. Claude Code uses `get_sleep_timeseries` to pull your sleep logs. You can write a shell script that runs this command daily and saves the JSON output to your local backup folder.

Run Claude Code and ask it to check your heart rate. It will call `get_heart_date` to display your resting heart rate and calories burned in the fat burn and cardio zones.

Run `claude mcp add` with the HTTP transport flags, specifying the server URL. Claude Code will save this to your local config file and instantly register the MCP Server tools.

Yes. Claude Code calls `get_cardio_fitness_score` to retrieve your current VO2 Max and percentile rankings. It prints this data directly to your terminal screen.

Your sensitive health data, such as oxygen saturation from `get_spo2` and breathing rates from `get_breathing_rate`, is protected using Vinkius's token system. Claude Code only receives the final API response, keeping your raw Fitbit credentials private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript