Provides access to Fitbit health and fitness data including activity tracking, sleep logs, heart rate, steps, body measurements, food and water logs, lifetime statistics, device information, and earned badges through Fitbit's public API.
Fitbit MCP (Model Context Protocol)
Disclaimer: This is an unofficial integration built using Fitbit's public API and is not affiliated with or endorsed by Fitbit Inc.
A Model Context Protocol (MCP) implementation for Fitbit, enabling AI assistants to access and analyze your Fitbit health and fitness data.
Usage
For JSON configuration (for use with AI assistant frameworks):
Or with arguments instead of environment variables:
Available Tools
This MCP provides the following tools for AI assistants to access your Fitbit data:
- getUserProfile: Get your Fitbit profile information
- getActivities: Get activity data for a specified date
- getSleepLogs: Get sleep data for a specified date
- getHeartRate: Get heart rate data for a specified date and period
- getSteps: Get step count for a specified date and period
- getBodyMeasurements: Get weight and body fat data
- getFoodLogs: Get food log data for a specified date
- getWaterLogs: Get water consumption data for a specified date
- getLifetimeStats: Get lifetime activity statistics
- getUserSettings: Get user settings and preferences
- getFloorsClimbed: Get floors climbed data
- getDistance: Get distance data
- getCalories: Get calories burned data
- getActiveZoneMinutes: Get active zone minutes data
- getDevices: Get information about connected Fitbit devices
- getBadges: Get earned badges and achievements
Most tools accept optional parameters:
date
: Date in YYYY-MM-DD format (defaults to today)period
: Time period for data (1d, 7d, 30d, 1w, 1m)
Obtaining a Fitbit Access Token
To get a Fitbit access token:
- Create an application at Fitbit Developer Portal
- Set OAuth 2.0 Application Type to "Personal"
- Set Callback URL to "http://localhost:3000"
- After creating the application, note your Client ID and Client Secret
- Use the OAuth 2.0 authorization flow to obtain an access token
For detailed instructions on OAuth authentication, see the Fitbit API Documentation.
Contributing
Contributions are welcome! Here's how you can contribute:
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add some amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
Every pull request triggers a GitHub Actions workflow that verifies the build process.
Development Setup
Release Process
To publish a new version to NPM:
- Update the version in
package.json
- Create a new GitHub release with a tag like
v1.0.1
- The GitHub Actions workflow will automatically build and publish the package to NPM
Make sure you have the NPM_TOKEN
secret configured in your GitHub repository settings.
License
This project is licensed under the MIT License - see the LICENSE file for details.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol (MCP) implementation for Fitbit, enabling AI assistants to access and analyze your Fitbit health and fitness data.
Disclaimer: This is an unofficial integration built using Fitbit's public API and is not affiliated with or endorsed by Fitbit Inc.
Related MCP Servers
- -securityFlicense-qualityFacilitates interaction and context sharing between AI models using the standardized Model Context Protocol (MCP) with features like interoperability, scalability, security, and flexibility across diverse AI systems.Last updated -1Python
- AsecurityFlicenseAqualityImplements the Model Context Protocol (MCP) to provide AI models with a standardized interface for connecting to external data sources and tools like file systems, databases, or APIs.Last updated -1125Python
- AsecurityAlicenseAqualityA Model Context Protocol server that bridges LLMs (like Claude) with the Fitbit API, allowing the LLM to request and retrieve user health and fitness data through defined tools.Last updated -3108TypeScriptMIT License
- AsecurityFlicenseAqualityAn all-in-one Model Context Protocol (MCP) server that connects your coding AI to numerous databases, data warehouses, data pipelines, and cloud services, streamlining development workflow through seamless integrations.Last updated -2Python