Garth
Get user profile information using Garth's UserProfile data class.
What is Garth?
Garth is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to get user profile information using garth's userprofile data class.
Get user profile information using Garth's UserProfile data class.
This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- user_profile
- user_settings
- weekly_intensity_minutes
- daily_body_battery
- daily_hydration
Use Cases
Maintainer
Works with
Installation
NPM
npx -y garth-mcp-serverManual Installation
npx -y garth-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Garth
The Garth MCP Server is a Garmin Connect integration for AI assistants, built on top of the garth Python library, that exposes 30 tools covering health metrics, fitness activities, device information, and gear statistics from a user's Garmin Connect account. It surfaces data like daily steps, sleep quality, heart rate variability, body battery, hydration, SpO2, and detailed activity splits, allowing AI assistants to analyze fitness trends, answer health questions, and generate insights from real Garmin data. Fitness-focused users and developers reach for it when they want to query their Garmin data in natural language without exporting CSV files or writing custom scripts.
Prerequisites
- Python 3.9+ and uv/uvx installed (recommended) or Node.js with npx
- A Garmin Connect account with data (any Garmin wearable)
- A GARTH_TOKEN generated by running 'uvx garth login' and authenticating with your Garmin credentials
- An MCP-compatible client such as Claude Desktop
Install uvx (if not already installed)
The garth-mcp-server is best run with uvx for Python MCP servers. Install uv which includes uvx.
curl -LsSf https://astral.sh/uv/install.sh | shGenerate your Garmin authentication token
Run the garth login command to authenticate with your Garmin Connect account and generate a GARTH_TOKEN. Copy the output token for use in your MCP configuration.
uvx garth loginConfigure your MCP client
Add the garth-mcp-server to your MCP client config. Use the full path to uvx since MCP clients do not use your shell PATH. On macOS, uvx is typically at /Users/{user}/.local/bin/uvx.
Optionally filter tools to reduce context size
By default all 30 tools are exposed. Use GARTH_ENABLED_TOOLS to whitelist only the tools you need, or GARTH_DISABLED_TOOLS to blacklist specific ones. Tool names are case-insensitive and comma-separated.
Verify the connection
Start your MCP client and ask the assistant to fetch your user profile or today's step count to confirm Garmin authentication is working.
Garth Examples
Client configuration
Add this block to claude_desktop_config.json. Replace the GARTH_TOKEN value with the output of 'uvx garth login' and update the uvx path to match your system.
{
"mcpServers": {
"Garth - Garmin Connect": {
"command": "/Users/yourname/.local/bin/uvx",
"args": ["garth-mcp-server"],
"env": {
"GARTH_TOKEN": "<output of uvx garth login>"
}
}
}
}Prompts to try
Example prompts that leverage the Garmin health, activity, and device tools:
- "What was my sleep score and total sleep duration last night?"
- "Show me my body battery levels for the past 7 days"
- "How many steps did I take this week compared to last week?"
- "Get the details and splits for my most recent running activity"
- "What is my current HRV status and weekly trend?"
- "List all my connected Garmin devices and their firmware versions"Troubleshooting Garth
Authentication errors or 'Invalid token' when calling Garmin tools
Garmin tokens expire. Re-run 'uvx garth login' to generate a fresh token, then update the GARTH_TOKEN value in your MCP config and restart your client.
uvx or garth-mcp-server command not found
MCP clients do not use your shell PATH. Use the full absolute path to uvx in the command field (e.g. /Users/yourname/.local/bin/uvx on macOS). Run 'which uvx' in your terminal to find the correct path.
Some tools return empty data or null values
Garmin only records data for metrics your device tracks. If you do not wear a device that measures SpO2 or blood pressure, those tools will return empty results. Use 'get_devices' to see what your connected device supports.
Frequently Asked Questions about Garth
What is Garth?
Garth is a Model Context Protocol (MCP) server that get user profile information using garth's userprofile data class. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Garth?
Install via npm with the command: npx -y garth-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Garth?
Garth works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Garth free to use?
Yes, Garth is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Garth Alternatives — Similar Analytics Servers
Looking for alternatives to Garth? Here are other popular analytics servers you can use with Claude, Cursor, and VS Code.
OpenMetadata
★ 14.0kOpenMetadata is a unified metadata platform for data discovery, data observability, and data governance powered by a central metadata repository, in-depth column level lineage, and seamless team collaboration.
Superset
★ 10.9kAn MCP server that provides AI assistants with full access to Apache Superset instances, enabling interaction with dashboards, charts, datasets, databases, and SQL execution capabilities.
Horizon
★ 4.4k📡 Your own AI-powered news radar. Generates daily briefings in English & Chinese. | 用 AI 构建你专属的新闻雷达
MCP Server Chart
★ 4.1kEnables generation of 25+ types of charts and data visualizations using AntV, including bar charts, line charts, maps, mind maps, and specialized diagrams like fishbone and sankey charts. Supports both statistical charts and geographic visualizations
Muapi CLI
★ 997Official CLI for muapi.ai — generate images, videos & audio from the terminal. MCP server, 14 AI models, npm + pip installable.
Weather MCP Server
★ 907Weather Data Fetcher MCP server built with Node.js, MCP SDK, and Zod. Provides weather details like temperature and forecast for cities such as Noida and Delhi via a registered tool. Simplifies API integration, enabling structured responses for clien
Browse More Analytics MCP Servers
Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Garth in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Garth?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.