−61%Holiday Watchface Bundle: 12 Garmin watch faces + 2 festive ones free — €19.99 instead of €51.38Holiday Bundle: 12 Garmin faces + 2 free — €19.99

Garmin Personal API: your own data, read by an AI assistant

Since October 2026 every Garmin Connect user can create a personal API key and pull their own activities, sleep, HRV and Body Battery as data. The key alone does nothing for an AI chat: a program has to exchange it for a token and fetch the data. Here is what the API really returns, how to create the key, and which way of connecting fits Claude, ChatGPT or another assistant.

How it works

  1. Garmin Connectyour account
  2. Personal API keyshown once
  3. Access tokenvalid 24 hours
  4. Your dataJSON and FIT files
  5. AI assistantreads only

You create the key once on the Garmin Connect website. A program exchanges it for an access token that works for 24 hours, then reads your data from Garmin: JSON for health data and activity summaries, the original FIT file for every recorded activity. Nothing can be written back. The AI assistant only sees what the program fetched.

What you can get

We checked every data set with a real account on 18 November 2026. The middle column is the longest date range one request accepts; for a longer period, fetch it in parts.

DataPer requestWhat is inside
ActivitiesWhole history, page by pageDistance, pace, heart rate and zones, training load and training effect; details and laps; the original FIT file
Sleep1 night, or 1 month of summariesDeep, light, REM and awake time, sleep need
HRVUp to 1 year of summariesOvernight average, 7-day average, baseline and status
Body Battery1 month (31 days)Charged, drained and the values through the day
Stress and steps28 daysDaily values
Daily summariesUp to 1 yearBody Battery, heart rate, stress, intensity minutes, respiration, pulse ox, calories
VO2 maxUp to 1 yearRunning and cycling values
Heart rate, SpO21 dayResting heart rate, values through the day, SpO2 averages
Also—Weight, hydration, heart rate zones, fitness age, menstrual cycle, food log, profile settings

Garmin does not publish rate limits, and its terms let it change them at any time.

What it does not give you

These answered «not found» in our test, or are not part of the personal key at all:

  • Training Readiness and Training Status
  • Race predictions and personal records
  • Saved workouts, the training calendar, gear and the list of your devices
  • Anything that writes: an AI cannot send a workout or a course to your watch. That needs Garmin’s Training and Courses APIs, which are only for approved business partners.
  • Live updates: data is there only after the watch has synced, and only when your program asks for it.

✓ VO2 max is available, even though some early guides say it is not.

Step 1: create your key

  1. Open Garmin Connect in a browser on a computer and sign in.
  2. Go to the Personal API key page in the settings (link below).
  3. Choose Create Key and read the additional terms: the key is for you only and may not be given to anyone else.
  4. Pick how long the key works: 30, 90 or 180 days, or 1 year. Choose the shortest period you need.
  5. Copy the key straight away and keep it in a password manager. Garmin shows it only once; if it is lost, delete it and create a new one.

Open the Personal API key page →

Garmin emails you about a week before a key expires. Deleting a key stops it, and every token made from it, at once.

Step 2: let your AI assistant read the data

Neither Claude nor ChatGPT can use the key by itself. Pick the way that matches the app you use.

  • Easiest and safest

    An assistant that runs commands on your computer

    Claude Code, OpenAI Codex CLI, Cursor and similar tools can run Garmin’s official command-line client. Install it (Python 3.12 or newer), save the key as one line in ~/.config/garmin/connect-personal-api-key, then ask the assistant to use gc-personal. The key stays in the file; the assistant reads the JSON the client prints.

    python3 -m pip install garmin-connect-personal-api-python
    chmod 600 ~/.config/garmin/connect-personal-api-key
    gc-personal sleep-summaries \
      --start-date 2026-10-21 --end-date 2026-11-17
  • Local server

    Claude Desktop and other apps with MCP

    Claude Desktop reads outside data through MCP servers that run on your computer. Garmin has no official one; several open-source servers use the Personal API. Pick one whose code you can read, keep it read-only, and put the key in its local config, not in the chat.

  • File upload

    ChatGPT, Gemini and other web chats

    A web chat cannot reach a program on your computer. Export the data with the official client and attach the JSON file to the chat. ChatGPT custom connectors need a server on the internet, and that means your key on that server.

    gc-personal --quiet body-battery \
      --start-date 2026-10-18 --end-date 2026-11-17 \
      > body-battery.json

✕ Never paste the key into a chat, a screenshot or a shared document.

✓ Give the AI the data, not the key.

Garmin’s official client on GitHub →

Hosted connectors and Garmin’s terms

Some web services offer to connect Garmin to ChatGPT or Claude for you. If a service asks you to paste your Personal API key, you are handing it to a third party. Garmin’s additional terms for the key do not allow that, and the key can be revoked. Services that work through Garmin’s business program ask for your consent through their own approved access and never need your personal key. Check which kind you are looking at before you sign up.

Questions that work

Ask for the fetch and the analysis in one message. A few ideas:

  • Fetch my sleep summaries and Body Battery for the last 4 weeks. Which nights did I recover worst, and what did I do the day before?
  • List my runs this year with distance, pace and average heart rate. At the same pace, is my heart rate going down?
  • Compare my HRV status over the last 3 months with my weekly training load.
  • Download the FIT file of my last long run and show pace and heart rate for each kilometre.
  • Fetch my stress for the last 3 months in 28-day parts and tell me which weekdays are the hardest.

Keep your data safe

  • The key opens your health data. Store it like a password and give it the shortest life that works.
  • Keep key files readable only by you (chmod 600) and out of git, cloud folders and shared backups.
  • Whatever the AI reads goes to the AI provider. Check its data settings, for example whether chats are used for training.
  • Done with the project? Delete the key on the Personal API key page.

Questions

Is the Garmin Personal API free?

Yes. Any Garmin Connect account can create a personal key. There is no application and no developer account.

Which watches does it work with?

It reads Garmin Connect, not the watch, so it covers whatever your watches have synced there. Which metrics exist depends on the model: HRV status or Body Battery appear only if your watch records them.

Can ChatGPT or Claude change something in my Garmin account?

No. The personal key only reads. It cannot send workouts, courses or settings to your watch.

How long does an access token last?

24 hours, or until the key expires if that comes first. There are no refresh tokens: the program asks for a new token with the key, and Garmin’s official client does that for you.

I lost my key. Can I see it again?

No. Garmin shows the key only once. Delete it and create a new one.

Can I see Body Battery or HRV on the watch itself?

Yes. Many watch faces show them right on the wrist; filter the catalog by your watch to find one.

Related

Checked on 18 November 2026 against Garmin’s personal API with a real account. Garmin may change the data sets and limits.

WatchFaceKit is not affiliated with Garmin, Anthropic or OpenAI. Garmin and Garmin Connect are trademarks of Garmin Ltd. or its subsidiaries, Claude is a trademark of Anthropic, ChatGPT is a trademark of OpenAI.