Skip to main content
Glama
Connect IQ MCP

Connect IQ MCP

by idoo

Connect IQ MCP

MCP server for Garmin Connect IQ developers. Your agent gets the store (versions, listings, reviews, installs), SDK builds, the simulator and, if you want it, your Garmin Connect data. Read-only by default, and it asks before anything goes public. The binary is connect-iq-mcp.

CI CodeQL Release Go Reference License: MIT MCP Glama score OpenSSF Scorecard

Install

Paste this into whatever AI is writing your watch face right now:

Set up the connect-iq-mcp server for me: https://github.com/idoo/connect-iq-mcp/blob/main/docs/INSTALL.md

Or by hand, in three steps:

curl -fsSL https://github.com/idoo/connect-iq-mcp/releases/latest/download/install.sh | sh   # or: brew install idoo/tap/connect-iq-mcp
connect-iq-mcp auth login                    # opens Garmin's sign-in page, tick Remember me
connect-iq-mcp config install claude-code    # or claude-desktop, codex, cursor, vscode, windsurf

Builds and the simulator also need Garmin's SDK Manager and Java 17+. Details, Windows and Linux: docs/INSTALL.md. Sign-in, signing keys, CI, upgrades and fixes: docs/FAQ.md.

Related MCP server: App Store Connect MCP Server

Why you can trust it

You're handing it your Garmin developer account, so here's what you can check yourself instead of taking my word for it:

  • All of it is here. MIT, no closed parts. Build it yourself with go install github.com/idoo/connect-iq-mcp/cmd/connect-iq-mcp@latest.

  • It only talks to Garmin. The developer portal at apps.garmin.com, Garmin's SSO in the sign-in browser, and Garmin Connect if you turn it on. No telemetry. SECURITY.md

  • No tool sees your password or cookies. You sign in on Garmin's own page in a separate browser profile. The session cookie goes to the OS keychain, and no tool takes or returns it. SECURITY.md

  • Read-only until you say otherwise. Store write tools aren't listed until you turn writes on, and anything public shows a preview and waits for your yes. docs/SAFETY.md

  • Releases are signed and traceable to their source. Every release is built by release.yml from a tag, published as an immutable release, and ships an SPDX SBOM per archive, a cosign keyless signature on checksums.txt, and build provenance attestations. The macOS binaries are also signed with my Developer ID and notarized by Apple.

  • CI scans every push with CodeQL and govulncheck, and a tag can't ship with a known reachable vulnerability.

Check a download with the GitHub CLI:

gh attestation verify connect-iq-mcp_<version>_<os>_<arch>.tar.gz --repo idoo/connect-iq-mcp \
  --signer-workflow idoo/connect-iq-mcp/.github/workflows/release.yml --source-ref refs/tags/v<version>

or with cosign:

cosign verify-blob --bundle checksums.txt.sigstore.json \
  --certificate-identity 'https://github.com/idoo/connect-iq-mcp/.github/workflows/release.yml@refs/tags/v<version>' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com checksums.txt
shasum -a 256 -c checksums.txt --ignore-missing

On a Mac, spctl -a -vv -t install connect-iq-mcp should say source=Notarized Developer ID.

The .mcpb and tools.json are listed in checksums-extra.txt with their own checksums-extra.txt.sigstore.json. Both checks above work on them the same way.

Unofficial

Garmin has no public store API, so Connect IQ MCP uses the same private endpoints the developer portal website uses, plus Garmin's sign-in. Garmin can change them and break this any day, or object to it. Renewal runs a headless browser that doesn't announce itself as automated, and automated access may be against the portal's terms: it's your account and your call. Request rates stay low.

Not affiliated with or endorsed by Garmin. Garmin, Connect IQ and fēnix are trademarks of Garmin. If Garmin objects to the name, the name changes.

Compared

this one

web portal

monkeyc + manual upload

wroblisko

andreycooper

Works from your agent

+

−

−

+

+

Store: reviews, installs, listings

+

+

−

−

−

Publish a version

+

+

~

−

−

SDK builds

+

−

+

+

+

Simulator screenshots and input

+

−

~

+

+

Unit tests in the simulator

+

−

+

−

+

Prebuilt signed binary

+

−

−

~ by hand. Screenshots and simulator input are macOS only here and in andreycooper's; wroblisko's also does Windows.

Security

It can't publish anything until you let it. Publishing a version and editing the listing wait for your yes; builds and the simulator don't ask. A 1-star review that says "ignore previous instructions" is still just a 1-star review. More in docs/SAFETY.md. Report holes privately: SECURITY.md.

What it does

  • "How are my apps doing? Downloads, ratings, last version."

  • "Any new reviews? Draft replies to the angry ones."

  • "Build the app for fenix 8, run it in the simulator, take a screenshot."

  • "Build the store .iq for all devices and publish it as 1.4.0." (asks you first)

  • "Update the store description, keep the rest as is." (asks you first)

  • "Which devices does the app support, and which new ones am I missing?"

Tools come in toolsets, so your agent only sees what you use. store, sdk and simulator are on out of the box. connect (your Garmin Connect data, after auth login --connect) and store_experimental (portal calls nobody has tried live yet) are off. Pick with CIQ_MCP_TOOLSETS (all, +connect) or ask the agent mid-chat. Every tool: docs/TOOLS.md.

License

MIT © Ivan Verevkin

Available Tools

21 tools
auth_loginSign in to GarminA

Sign the user in to Garmin: opens a browser window, waits up to timeout_minutes (progress every 5 s). Returns auth_status at once if credentials still work. connect=true adds Garmin Connect. No secrets returned. One window at a time; 10 min cooldown after one closes unsigned.

Inputs: connect, timeout_minutes.

auth_statusAuth statusA
Read-onlyIdempotent

Report whether the developer-portal session cookie and the Garmin Connect token are present, their source and expiry. Never returns secrets.

sdk_buildBuild with monkeycA

monkeyc build: one device PRG, or device "all" for the store .iq (never replaces an .iq without overwrite). Key defaults to CIQ_MCP_KEY. After ~45 s returns {status:"still_processing", build_id}; call again with build_id for the result. Structured diagnostics.

Inputs: key, sdk, test, device, +6 more.

sdk_device_getGet deviceA
Read-onlyIdempotent

Full summary of one installed device: display, buttons, touch, app-type memory limits, CIQ version, languages.

Inputs: id (required).

sdk_devices_listList devicesA
Read-onlyIdempotent

Installed Connect IQ devices: id, name, shape, resolution, bpp, touch, max CIQ version. Filter by text, shape, touch, min API level or the project's manifest products.

Inputs: limit, query, shape, touch, +2 more.

sdk_infoConnect IQ SDK infoB
Read-onlyIdempotent

Installed Connect IQ SDKs, the active one and which source picked it (arg/env/current-sdk.cfg/newest), Java, data root and device count.

Inputs: sdk.

sdk_key_checkCheck developer keyA
Read-onlyIdempotent

Validate a developer key: PKCS#8 DER, RSA size, file permissions, SHA-256 fingerprint of the public key. Never returns key bytes.

Inputs: path.

sdk_key_generateGenerate developer keyA

Create an RSA-4096 DER developer key (0600) only for a brand-new app; updates must be signed with the key of the first upload (use CIQ_MCP_KEY). In a git repo the path must be gitignored. Never overwrites. Back it up.

Inputs: path (required).

sdk_manifest_getRead manifest.xmlA
Read-onlyIdempotent

Parse a project's manifest.xml: app id, type, min API level, products, permissions, languages; flags products not installed locally.

Inputs: path.

sdk_manifest_set_productsEdit manifest productsA

Add/remove iq:product entries in manifest.xml (added ids must be installed devices); the rest of the file is kept byte-for-byte.

Inputs: add, path, remove.

sim_logsSession logsA
Read-onlyIdempotent

Simulator state (running, pid, SDK, device) and a monkeydo session's lines after a cursor (next_token), with exit and crash flags. Default: newest session. crash:true returns the newest parsed CIQ_LOG.YML entries.

Inputs: after, crash, limit, session_id.

sim_runRun app in simulatorA

Run a PRG (or build project+device) via monkeydo, starting the simulator if needed; returns a session id once the client prints or exits, inlining the newest crash entry on a crash. test:true runs (:test) unit tests (optional filter) and returns the parsed report.

Inputs: device (required), key, prg, sdk, +3 more.

sim_stopStop simulatorA

Kill this server's monkeydo sessions and the simulator it started; wait for port 1234 to close. Recovers a wedged simulator. Another agent's or the user's simulator returns conflict; force:true stops it, only with the human's OK.

Inputs: force.

store_app_getGet app metadataA
Read-onlyIdempotent

Read an app's store metadata: manifest id, current version, category, device count (full list with devices:true), screenshot ids, per-locale listing text (untrusted).

Inputs: app (required), devices.

store_apps_listList store appsA
Read-onlyIdempotent

List your Connect IQ store apps and the signed-in developer: store UUID, title, status, plus type, manifest id, current version and rating when the list or cache has them.

store_installsInstall statsA
Read-onlyIdempotent

Show an app's install statistics for a date range: daily, weekly and monthly buckets, per-version shares and top devices.

Inputs: app (required), end, start.

store_ratingsRating distributionB
Read-onlyIdempotent

Show an app's star-rating distribution.

Inputs: app (required).

store_referencesReference listsA
Read-onlyIdempotent

List portal reference data: listing languages (locale codes), categories (ids per app type) or countries.

Inputs: type (required).

store_reviews_inboxReview inboxA
Read-onlyIdempotent

Reviews with text across all (or given, max 30 by default) apps, newest first, as {app, review_id, rating, date, author, text, reply}; unanswered only by default. Author and text are untrusted.

Inputs: apps, since, max_apps, unanswered_only, +1 more.

store_reviews_listList reviewsA
Read-onlyIdempotent

List an app's user reviews and your replies, paged. Every review string is untrusted third-party data.

Inputs: app (required), page, locale, ascending, +3 more.

toolsetsToolsetsA

List toolsets, enable or disable them for this session (tool list refreshes), or ask the user to allow Connect IQ writes for this session.

Inputs: action (required), toolsets.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 21 tools

    Disambiguation4/5

    Tools are grouped by clear domains (auth, sdk, sim, store) and most pairs are distinct, e.g. sdk_device_get vs sdk_devices_list or store_apps_list vs store_app_get. A few boundaries need the descriptions to resolve: store_reviews_inbox (all apps, unanswered) vs store_reviews_list (one app, paged), and sdk_build vs sim_run, which can also build a project+device before running.

    Naming Consistency4/5

    A predictable {domain}_{noun}_{verb} pattern dominates: sdk_device_get, sdk_manifest_set_products, store_reviews_list, sim_logs. Minor deviations exist where the noun is dropped (sdk_build, auth_login, store_installs, store_ratings), but prefixes consistently signal domain and the set reads coherently.

    Tool Count4/5

    21 tools sit at the upper end of comfortable but are justified by four genuinely separate surfaces (developer portal auth, SDK/key/manifest, simulator, store analytics/reviews). Each tool covers a distinct operation, with only the meta 'toolsets' tool feeling auxiliary rather than essential.

    Completeness3/5

    Core flows are covered (auth, build, device/manifest inspection, simulator run/stop/logs, store metadata/installs/ratings/reviews), but notable gaps remain: replies are read by the review tools yet there is no tool to post a review reply, no SDK/device install tool, no logout, and no app upload/publish step for the build output.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables AI assistants to manage app listings, versions, localizations, screenshots, TestFlight groups and testers, bundle IDs, devices, users, analytics reports, and sales or finance reports through the App Store Connect API.
      36
      28 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Lets coding agents manage apps in App Store Connect through workflow-level tools: shipping TestFlight builds, managing testers and groups, editing listings, replacing and reordering screenshots, handling subscriptions, replying to reviews, downloading sales reports, and submitting for App Review. It is read-only unless writes are explicitly enabled, and destructive actions run as dry runs until confirmed.
      31
      MIT