Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Suunto MCP

by googlarzversion 1.3.0i★ 40iRuns on your computerRepository ↗
Registry nameio.github.googlarz/suunto-mcp

How to install

What it does

Suunto watch data (workouts, sleep, recovery, 24/7 activity) for Claude and other AI assistants.

  • Connects Runs on your computer
  • Account or key Needs SUUNTO_CLIENT_SECRET, SUUNTO_SUBSCRIPTION_KEY · 1 setting to fill in (SUUNTO_CLIENT_ID)
  • Category Clinics & health

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity33/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score45/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: 179 (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Suunto MCP. Follow https://mcp.popnx.com/i/googlarz-suunto-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 17, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a Suunto MCP key (create it on the maker’s site) · 1 setting(s) to fill in (SUUNTO_CLIENT_ID) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Suunto MCP for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "suunto": { "command": "npx", "args": [ "-y", "suunto-mcp" ], "env": { "SUUNTO_CLIENT_ID": "your-value", "SUUNTO_CLIENT_SECRET": "your-value", "SUUNTO_SUBSCRIPTION_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For SUUNTO_CLIENT_SECRET, SUUNTO_SUBSCRIPTION_KEY, SUUNTO_CLIENT_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Suunto MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Suunto MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Suunto MCP site ↗

  3. Fill in 1 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    Descriptions are as written by the maker.

  4. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  5. Paste these settings and save the file

    {
      "mcpServers": {
        "suunto": {
          "command": "npx",
          "args": [
            "-y",
            "suunto-mcp"
          ],
          "env": {
            "SUUNTO_CLIENT_ID": "your-value",
            "SUUNTO_CLIENT_SECRET": "your-value",
            "SUUNTO_SUBSCRIPTION_KEY": "your-value"
          }
        }
      }
    }

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Quit Claude and open it again

  7. Try it

    Use Suunto MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Suunto MCP or shows a Suunto MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Suunto MCP yet

Suunto MCP runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Suunto MCP

  • You need a Suunto MCP key (create it on the maker’s site) · 1 setting(s) to fill in (SUUNTO_CLIENT_ID) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • You need a Suunto MCP key (create it on the maker’s site) · 1 setting(s) to fill in (SUUNTO_CLIENT_ID) · Install Node.js on your computer first (one time)
  • You need a Suunto MCP key (create it on the maker’s site) · 1 setting(s) to fill in (SUUNTO_CLIENT_ID) · Install Node.js on your computer first (one time)
  • You need a Suunto MCP key (create it on the maker’s site) · 1 setting(s) to fill in (SUUNTO_CLIENT_ID) · Install Node.js on your computer first (one time)

B · Others in Clinics & health that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a Suunto MCP key (create it on the maker’s site) · 1 setting(s) to fill in (SUUNTO_CLIENT_ID) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Suunto MCP for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user suunto --env SUUNTO_CLIENT_ID=your-value --env SUUNTO_CLIENT_SECRET=your-value --env SUUNTO_SUBSCRIPTION_KEY=your-value -- npx -y suunto-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For SUUNTO_CLIENT_SECRET, SUUNTO_SUBSCRIPTION_KEY, SUUNTO_CLIENT_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Suunto MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Suunto MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Suunto MCP site ↗

  3. Fill in 1 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • SUUNTO_CLIENT_ID Suunto API zone OAuth client ID

    Descriptions are as written by the maker.

  4. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  5. Paste this command and press Enter

    claude mcp add --scope user suunto --env SUUNTO_CLIENT_ID=your-value --env SUUNTO_CLIENT_SECRET=your-value --env SUUNTO_SUBSCRIPTION_KEY=your-value -- npx -y suunto-mcp

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Type /mcp in Claude Code

    You should see Suunto MCP listed as connected

  7. Try it

    Use Suunto MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Suunto MCP or shows a Suunto MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a Suunto MCP key (create it on the maker’s site) · 1 setting(s) to fill in (SUUNTO_CLIENT_ID) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Suunto MCP for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "suunto": { "command": "npx", "args": [ "-y", "suunto-mcp" ], "env": { "SUUNTO_CLIENT_ID": "your-value", "SUUNTO_CLIENT_SECRET": "your-value", "SUUNTO_SUBSCRIPTION_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For SUUNTO_CLIENT_SECRET, SUUNTO_SUBSCRIPTION_KEY, SUUNTO_CLIENT_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Suunto MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Suunto MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Suunto MCP site ↗

  3. Fill in 1 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • SUUNTO_CLIENT_ID Suunto API zone OAuth client ID

    Descriptions are as written by the maker.

  4. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  5. Fill in your key

    In the Suunto MCP settings, SUUNTO_CLIENT_SECRET, SUUNTO_SUBSCRIPTION_KEY, SUUNTO_CLIENT_ID is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Open the AI chat in Cursor in Agent mode

  7. Try it

    Use Suunto MCP and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Suunto MCP or shows a Suunto MCP tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a Suunto MCP key (create it on the maker’s site) · 1 setting(s) to fill in (SUUNTO_CLIENT_ID) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Suunto MCP for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "suunto": { "type": "stdio", "command": "npx", "args": [ "-y", "suunto-mcp" ], "env": { "SUUNTO_CLIENT_ID": "your-value", "SUUNTO_CLIENT_SECRET": "your-value", "SUUNTO_SUBSCRIPTION_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For SUUNTO_CLIENT_SECRET, SUUNTO_SUBSCRIPTION_KEY, SUUNTO_CLIENT_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Suunto MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Suunto MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Suunto MCP site ↗

  3. Fill in 1 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • SUUNTO_CLIENT_ID Suunto API zone OAuth client ID

    Descriptions are as written by the maker.

  4. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  5. Fill in your key

    In the Suunto MCP settings, SUUNTO_CLIENT_SECRET, SUUNTO_SUBSCRIPTION_KEY, SUUNTO_CLIENT_ID is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Open the AI chat in VS Code in Agent mode

  7. Try it

    Use Suunto MCP and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Suunto MCP or shows a Suunto MCP tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Suunto MCP💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user suunto --env SUUNTO_CLIENT_ID=your-value --env SUUNTO_CLIENT_SECRET=your-value --env SUUNTO_SUBSCRIPTION_KEY=your-value -- npx -y suunto-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "suunto": {
      "command": "npx",
      "args": [
        "-y",
        "suunto-mcp"
      ],
      "env": {
        "SUUNTO_CLIENT_ID": "your-value",
        "SUUNTO_CLIENT_SECRET": "your-value",
        "SUUNTO_SUBSCRIPTION_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "suunto": {
      "command": "npx",
      "args": [
        "-y",
        "suunto-mcp"
      ],
      "env": {
        "SUUNTO_CLIENT_ID": "your-value",
        "SUUNTO_CLIENT_SECRET": "your-value",
        "SUUNTO_SUBSCRIPTION_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "suunto": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "suunto-mcp"
      ],
      "env": {
        "SUUNTO_CLIENT_ID": "your-value",
        "SUUNTO_CLIENT_SECRET": "your-value",
        "SUUNTO_SUBSCRIPTION_KEY": "your-value"
      }
    }
  }
}

Values you fill in

  • SUUNTO_CLIENT_ID required env
    Suunto API zone OAuth client ID
  • SUUNTO_CLIENT_SECRET secret required env
    Suunto API zone OAuth client secret
  • SUUNTO_SUBSCRIPTION_KEY secret required env
    Suunto API zone subscription key

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
2,085/wk
Connection
Runs on your computer
Latest versioni
1.3.0
Published to registryi
Nov 17, 2026
Code last changedi
Nov 17, 2026
Maker
googlarz
Packages
npm: suunto-mcp
Website
github.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account googlarz, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 2 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked yet

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/googlarz-suunto-mcp.svg)](https://mcp.popnx.com/en/servers/googlarz-suunto-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Clinics & healthi

  • More stars than 97% of the other 1190 servers in this category
  • Published to the registry more recently than 92% of the other 1190 servers in this category
  • Basic checks equal to or better than 99% of the other 1190 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Suunto MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: SUUNTO_CLIENT_SECRET, SUUNTO_SUBSCRIPTION_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 2 days ago, and the latest version (1.3.0) reached the registry 2 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Medplum MCP, Mirobody, Codescene MCP Server, Marrow, WHOOP — MissingMCP

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Medplum MCP

Securely access and manage FHIR healthcare data stored in Medplum.

by medplumWidely used★ 2.8KUpdated 4 months ago

Runs in the cloud✓ service owner · medplum.com

Mirobody

Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.

by thetahealthGrowing↓ 725/wk★ 1.6KUpdated 9 days ago

Runs on your computer✓ thetahealth.ai

Codescene MCP Server

An MCP server that provides CodeScene Code Health analysis tools.

by codescene-ossGrowing↓ 3.8K/wk★ 85Updated 8 months ago

Runs on your computer✓ service owner · codescene.com

Marrow

Marrow Health: your Apple Health data over MCP, from the free iOS app. Reads, and writes on demand.

by skeletonarmytechEarly↓ 62/wk★ 5Updated 28 days ago

Runs on your computer✓ skeletonarmy.tech
Compared with similar ones
This one
Suunto MCP
Medplum MCPMirobodyCodescene MCP ServerMarrowWHOOP — MissingMCP
Runs whereInstalls on your computerRuns in the cloud, nothing to installInstalls on your computerInstalls on your computerInstalls on your computerRuns in the cloud, nothing to install
Needs a keyYesNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/43/32/33/32/4
LicenseMITApache-2.0Apache-2.0NOASSERTIONMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Suunto MCP

Ask Claude anything about your training. Suunto MCP connects your Suunto watch data to Claude so you can just talk to your data instead of clicking through dashboards.

*Built by a Suunto user who wanted to ask "how was my last long run?" and get a real answer with numbers — and to feed live training data into a personal AI coach.*

🏃 For regular Suunto users: Suunto's API docs say access is for commercial partners only — that's not the full picture. Private users get access too. It just takes 3–4 weeks for approval after you apply. Submit, wait, enjoy. Don't let that disclaimer stop you. ✅


What you can do

Once it's set up, just ask:

  • *"How many kilometers did I run this month?"*
  • *"Compare my last three long runs — has my heart-rate drift improved?"*
  • *"How did my heart rate hold up set by set in last night's gym session?"*
  • *"What's my average resting HR trend over the last two weeks?"*
  • *"Summarize my training week in the style of a coaching report."*
  • *"I've been feeling off — how do my recovery scores compare to last month?"*
  • *"Find every workout where I averaged above 160 bpm."*
  • *"Which of my runs this year had the most elevation?"*
  • *"What should next week's gym sessions look like, given what I actually lifted?"*
  • *"If I add a hard session on Thursday, where does my form end up on race day?"*

Claude figures out what data to pull. You just ask.

It's not just read-only either — Claude can push things to your watch too:

  • *"Plan tonight's gym session and send it to my watch."*
  • *"Upload yesterday's Garmin export as a Suunto workout."*
  • *"Export my last route as GPX so I can share it."*

See What you can push to your watch below.


🤖 Don't want to do this yourself? Let Claude Code install it

If you already have Claude Code, you don't need to run a single terminal command. Just open it and say:

*"Please install and set up suunto-mcp from https://github.com/googlarz/suunto-mcp"*

Claude Code will clone the repo, run all the install commands, and add everything to your Claude Desktop config — on its own. That's exactly how this project's author set it up: no manual terminal work.

Three things stay yours no matter what, by design, not because of missing tooling:

  1. Creating the apizone.suunto.com account — Claude can't create accounts on your behalf.
  2. The apizone web form (naming your app, revealing your subscription key) — it's your account session; Claude tells you exactly where to click, but can't click there for you.
  3. Clicking "Authorize" during login — that's OAuth working as intended. An app that could approve its own access wouldn't be secure.

Claude will tell you exactly what to do and when for each of these.

If you want to do it manually, keep reading.


What you need

Before starting, make sure you have:

  • A Suunto watch synced to the Suunto app (any modern model — Race, Vertical, 9 Peak, 5 Peak, Ocean, etc.)
  • Claude Desktop (or another MCP-compatible AI app)
  • Node.js — free, download here, choose the "LTS" version
  • Git — free, download here
  • ~5 min to submit + 3–4 week wait for Suunto approval + ~15 min to install

Once it's done, you never redo it.


Setup

Prefer one guided walkthrough with a pacing choice up front (fast path

vs. explained-step-by-step) and a proper explanation of how syncing works?

See GETTING_STARTED.md. What follows here is the same

steps in reference form.

The setup has three parts:

  1. Register with Suunto's developer portal — tells Suunto your app is allowed to read your data
  2. Install and configure — gets the software running on your computer
  3. Connect to Claude — lets the AI find and use it

Try it without an account (demo mode)

Suunto takes 3–4 weeks to approve API access. You don't have to wait to see what this does: with SUUNTO_DEMO=1 the server runs on realistic synthetic data (about 8 weeks, ending today) and needs no Suunto account, no credentials and no network. Only Node.js is required. Add this to the mcpServers block of the Claude Desktop config (the file from Step 9), then restart Claude:

{

"mcpServers": { "suunto-demo": { "command": "npx", "args": ["-y", "suunto-mcp"], "env": { "SUUNTO_DEMO": "1" } } } }

What works: every read tool and the four prompts (suunto-morning, suunto-weekly, suunto-gym-today, suunto-gym-review) — workouts with guide-labelled gym laps (three sessions a week, one of them with a planted deviation for compare_workout_to_plan and one with a heart-rate dropout, so the hrQuality flag shows), one or two runs a week with TSS, nightly sleep with stages, score and HRV plus the odd nap, recovery every 30 minutes, daily steps and energy, two routes, three guides, and a small FIT file with heart rate for get_workout_fit and get_workout_rest_profile. Training load, baselines and snapshots are computed from that data by the normal code.

log_prediction, void_prediction, score_predictions, get_prediction_stats, start_experiment, get_experiment, log_experiment_day, analyze_experiment, stop_experiment and draft_session_log work too: the ledger starts with a month of synthetic predictions waiting to be scored and the experiments with one finished synthetic experiment, all in memory and never on disk. set_plan, get_plan, get_catchup, archive_workouts, get_archive_status, import_workouts, get_import_status and get_weekly_report (its save too) work too, on in-memory state only: the plan, the catch-up marker, the workout archive and the imported workouts live as long as the server process and never reach the disk (import_workouts still reads the files you point it at). get_tag_effects runs on a small synthetic journal (gym sessions tagged strength, Saturday runs long-run); your real journal is not read.

push_week_plan works as a dry run (its default: it validates the guides and returns what it would push, and contacts nothing). propose_next_week and simulate_plan work too: with no plan stored, the proposal starts from the demo programme (PUSH A, PULL B, LEGS C) and lifts the demo lifter logged, so it shows a hold and a deload; everything is generated and nothing is written. The approval queue (queue_adjustment, list_approvals, resolve_approval) and get_data_overview work on the in-memory stores; resolve_approval with push: true never pushes there.

What does not: anything else that writes (upload_workout, upload_route, push_*_guide, push_week_plan with dryRun: false, delete_guide, generate_daily_digest, log_session) writes nothing and only returns a short note on what it would do with real credentials. get_upload_status has no uploads to find.

You can't mistake demo data for real data: every tool result is JSON with a top-level "demo": true (a result that is a list, or text such as a GPX file, comes back as { "demo": true, "data": … }), the server's instructions and the prompts say the data is synthetic, and the startup line says DEMO MODE. Errors are unchanged. npm run doctor with SUUNTO_DEMO=1 just reports that demo mode is on. When your API access arrives, remove SUUNTO_DEMO and follow the setup below. Demo mode applies to the MCP server only, not to the terminal commands.


One-click install (.mcpb bundle)

If you do not want to touch a terminal to try it, a .mcpb file is a single file you open with Claude Desktop. It carries its own copy of the server and its libraries, so installing it and using demo mode needs no Git, no npm and no setup of your own. (It still needs a Node.js runtime to run: the manifest asks the host for Node 20 or newer, and Claude Desktop is expected to provide one for extensions, which has not been checked here. Pairing your own account does need Node.js on your computer: see step 4.)

What you do (plain steps):

  1. Get suunto-mcp- .mcpb. There is no download link yet: whoever maintains your copy builds it with npm run pack:mcpb (it appears in the build/ folder), or you build it yourself from the cloned folder the same way.
  2. Double-click the file, or open Claude Desktop and drag it into Settings, Extensions. Claude shows an install screen; click Install.
  3. The screen has a few boxes. Leave Demo mode ticked and everything else empty: you can ask Claude about a made-up training history straight away, with no Suunto account. Every answer is marked as demo data.
  4. To use your own data later, three things are needed, and the file does not replace any of them:
  • Suunto's developer API access (the 3-4 week approval in Part 1 below; there is no way around it).
  • Your three values in the boxes: untick Demo mode, fill in the client ID, client secret and subscription key from apizone.suunto.com, restart Claude. Claude Desktop stores these as sensitive values.
  • One-time pairing, in a terminal, with Node.js 20 or newer installed on your computer (download it from nodejs.org; the bundle's own copy is not something you can run from a terminal). Run npx -y -p suunto-mcp suunto-mcp-auth with the same three values set as environment variables in that terminal (SUUNTO_CLIENT_ID, SUUNTO_CLIENT_SECRET, SUUNTO_SUBSCRIPTION_KEY; and the redirect address from Step 3 must be registered on apizone). Your browser opens, you approve, and the tokens are saved to ~/.suunto-mcp/tokens.json, which the bundle then reads. The bundle adds no new sign-in: this is the same suunto-mcp-auth as Step 7 (npm run auth in a cloned folder also works, and needs Git as well).

What is in the file: manifest.json, the compiled server (dist/), its production dependencies (node_modules/), a minimal package.json and the licence. Nothing else: no sources, tests, .env, token or credential files (the packer refuses any file with such a name, and a test checks the produced file's listing). Nothing is uploaded anywhere by the command; it only writes build/suunto-mcp- .mcpb (the build/ folder is not committed).

Not verified (read before relying on it):

  • The file has not been opened in Claude Desktop or any other host: the manifest follows the published MCPB manifest spec (version 0.3), and a test starts the unpacked entry point the way a host does, but host-side behaviour is untested. In particular it is unknown how a given host writes a ticked box (the bundle accepts true or 1) or an empty optional box (a blank value, or the literal ${user_config...} text: both are treated as not set).
  • No signing: the file is unsigned, so a host may warn that it comes from an unknown publisher.
  • No automatic updates: a new version means a new file. The version in manifest.json must equal package.json (a test enforces it).
  • No icon: the manifest declares none.
  • Built as plain JavaScript (the optional OS-keychain module is left out, so SUUNTO_TOKEN_STORAGE=keychain is not available in the bundle); only the platform it was packed on has been checked.
  • Packing needs network access once (npm ci of the production dependencies from package-lock.json).
Part 1: Register with Suunto's developer port

Only the beginning is shown; read the rest in the repo