https://github.com/Taxuspt/garmin_mcp
MCP server to access Garmin data
https://github.com/Taxuspt/garmin_mcp
Last synced: about 2 months ago
JSON representation
MCP server to access Garmin data
- Host: GitHub
- URL: https://github.com/Taxuspt/garmin_mcp
- Owner: Taxuspt
- License: mit
- Created: 2025-03-08T23:48:51.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-07-22T09:54:09.000Z (4 months ago)
- Last Synced: 2025-07-22T11:42:55.030Z (4 months ago)
- Language: Python
- Size: 20.5 KB
- Stars: 56
- Watchers: 3
- Forks: 13
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **garmin_mcp** - MCP server to access Garmin data `python` `mcp` `server` `pip install git+https://github.com/Taxuspt/garmin_mcp` (🤖 AI/ML)
- awesome-mcp-servers - **garmin_mcp** - MCP server to access Garmin data `python` `mcp` `server` `pip install git+https://github.com/Taxuspt/garmin_mcp` (AI/ML)
README
[](https://mseep.ai/app/taxuspt-garmin-mcp)
# Garmin MCP Server
This Model Context Protocol (MCP) server connects to Garmin Connect and exposes your fitness and health data to Claude and other MCP-compatible clients.
## Features
- List recent activities
- Get detailed activity information
- Access health metrics (steps, heart rate, sleep)
- View body composition data
## Setup
1. Install the required packages on a new environment:
```bash
uv sync
```
## Running the Server
### With Claude Desktop
1. Create a configuration in Claude Desktop:
Edit your Claude Desktop configuration file:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
Add this server configuration:
```json
{
"mcpServers": {
"garmin": {
"command": "uvx",
"args": [
"--python", "3.12",
"--from", "git+https://github.com/Taxuspt/garmin_mcp",
"garmin-mcp"
],
"env": {
"GARMIN_EMAIL": "YOUR_GARMIN_EMAIL",
"GARMIN_PASSWORD": "YOUR_GARMIN_PASSWORD"
}
}
}
}
```
Replace the path with the absolute path to your server file.
2. Restart Claude Desktop
### With MCP Inspector
For testing, you can use the MCP Inspector:
```bash
npx @modelcontextprotocol/inspector python /Users/adomingues/Documents/claude_filesystem/garmin_mcp/garmin_mcp_server.py
```
## Usage Examples
Once connected in Claude, you can ask questions like:
- "Show me my recent activities"
- "What was my sleep like last night?"
- "How many steps did I take yesterday?"
- "Show me the details of my latest run"
## Security Note
## Troubleshooting
If you encounter login issues:
1. Verify your credentials are correct
2. Check if Garmin Connect requires additional verification
3. Ensure the garminconnect package is up to date
For other issues, check the Claude Desktop logs at:
- macOS: `~/Library/Logs/Claude/mcp-server-garmin.log`
- Windows: `%APPDATA%\Claude\logs\mcp-server-garmin.log`