A previous release had provenance metadata, but this release does not. View details.
How to connect Garmin Connect to Claude Code, ChatGPT and any AI agent
Yes, Claude, ChatGPT and other AI agents can work in your Garmin Connect account. Garmin's own API is pull-only and made for developers. Cotlet.dev connects your own Garmin Connect account to any AI agent, so the AI can read your training and build and schedule workouts for you.
What you can ask
Build a 10 km tempo run workout and put it on my Garmin calendar for Thursday.
How did my sleep and HRV change over the last 4 weeks?
Plan my next 8 weeks for a half marathon and schedule the workouts.
Compare my last three long runs: pace, heart rate, cadence.
What's my VO2 max trend this year?
Connect in 2 minutes
Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
ChatGPT
Settings → Apps → add connector URL https://cotlet.dev/mcp/v1, then sign in with Cotlet.dev. No API key needed.
Cursor
Copy .cursor/mcp.json from this repo into your project:
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}
Run it locally (stdio)
This repo is a real MCP server. It speaks MCP over stdio, lists its Garmin Connect tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.
{"mcpServers":{"garmin":{"command":"uvx","args":["garmin-cotlet-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}
Or with Docker:
docker build -t garmin-mcp .
docker run -i --rm -e COTLET_API_KEY garmin-mcp
Tools: garmin_guide, garmin_status, garmin_open, garmin_read, garmin_click, garmin_type, garmin_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
Command line
Python 3.10+, nothing else to install. From PyPI:
pip install garmin-cotlet-mcp # or run it once: uvx garmin-cotlet-mcp connect
garmin-cotlet-mcp connect
Or straight from this repo:
export COTLET_API_KEY="your-key"
python3 garmin_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 garmin_agent.py status # is Garmin Connect ready in your Cotlet.dev account
python3 garmin_agent.py guide # Garmin Connect screens and sign-in link
python3 garmin_agent.py read # open Garmin Connect, read the page, close the browser
python3 garmin_agent.py tools # list Cotlet.dev tools
python3 garmin_agent.py serve # start the stdio MCP server (same as no argument)
Questions from Garmin Connect users
Does Garmin Connect have an API?
Garmin has a personal, pull-only API and a business Health API for developers. Neither lets an AI agent create and schedule workouts for you. Cotlet.dev works in your own Garmin Connect account, so it can.
How do I connect my Garmin to Claude AI?
Add Cotlet.dev to Claude (the claude mcp add command above, or a custom connector in the Claude app), sign in to Garmin Connect once in your Cotlet.dev Cloud Browser, and ask Claude about your training.
How do I connect Garmin Connect to ChatGPT?
Add Cotlet.dev as an app in ChatGPT (Settings → Apps, connector URL https://cotlet.dev/mcp/v1), sign in to Garmin Connect once in your Cotlet.dev Cloud Browser, and ask ChatGPT in plain words. No code and no Garmin Connect API key.
Is there a Garmin Connect MCP server?
Garmin Connect has no official MCP server. Cotlet.dev is a hosted MCP server that works in Garmin Connect for you, 24/7, with Claude, ChatGPT, Cursor, Codex, n8n, Make and Zapier.
Find it on
- Garmin Connect on Cotlet.dev
- PyPI package garmin-cotlet-mcp
- Glama
- Step-by-step guide (PDF) on Internet Archive
Also works with
- Mangomint MCP
- Wanderlog MCP
- SmugMug MCP
- Housecall Pro MCP
- Medium MCP
- Crexi MCP
- DistroKid MCP
- LinkedIn MCP
- EstimateOne MCP
- All apps connected through Cotlet.dev
Start free: https://cotlet.dev/signup?app=garmin&utm_source=github&utm_medium=readme&utm_campaign=garmin
Metadata
Release files for garmin-cotlet-mcp 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Loss of provenance
These files do not have provenance metadata, despite files in a prior release including this data.
We recommend further investigation before installing these files. View details.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| garmin_cotlet_mcp-1.1.0.tar.gz | 8.4 kB | Without provenance | Details for garmin_cotlet_mcp-1.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| garmin_cotlet_mcp-1.1.0-py3-none-any.whl | Python 3 | none | any | Details for garmin_cotlet_mcp-1.1.0-py3-none-any.whl |
Total release size: 17.0 kB
Release files / garmin_cotlet_mcp-1.1.0.tar.gz
Loss of provenance
This file belongs to a release without provenance metadata, despite a prior release including this data.
We recommend further investigation before installing this file. View details.
| Download URL | garmin_cotlet_mcp-1.1.0.tar.gz |
|---|---|
| Size | 8.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1e4a92ad71ba08bb2c1e68086026f32f3dff959f6eea56a31e13084b5ff41ba9
|
|
BLAKE2b-256 checksum How to use checksums |
63f31239ad4a664ea3155c4d7362c51656666e205b2d1fd601addd863da8b4ed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / garmin_cotlet_mcp-1.1.0-py3-none-any.whl
Loss of provenance
This file belongs to a release without provenance metadata, despite a prior release including this data.
We recommend further investigation before installing this file. View details.
| Download URL | garmin_cotlet_mcp-1.1.0-py3-none-any.whl |
|---|---|
| Size | 8.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
18fb9bc31bfdbc10502bf035d54bb0251b57e5e643bec2a96cfdb966f724f97e
|
|
BLAKE2b-256 checksum How to use checksums |
ee9d25dcff352659e92560f59f62f45f70f0ce6aa7160b8e100bf12f7122e9a8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for garmin-cotlet-mcp 1.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Loss of provenance
A previous release of these files had provenance metadata, but this release does not.
While this could reflect a routine change by the project maintainers, it may also indicate that the release files have been compromised.
Release comparison
- Removed 1.0.0 2 files With provenance
- Added 1.1.0 2 files Without provenance
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.