Skip to content
 
 

Repository files navigation

carelink-bridge

CI Latest release License: MIT

Sends your Medtronic pump and CGM data to Nightscout automatically, by logging into Medtronic's CareLink servers the same way the official CareLink app does and uploading what it gets.

Community fork. This is a community-maintained fork of domien-f/carelink-bridge. Original code by @domien-f. Maintained by NovaLux12 while upstream is quiet. PRs and issues welcome here.

This fork includes the BLE device detection fix from upstream PR #2 by @terminalcommand, which fixes empty-data issues on 780G, Guardian 4, and Simplera CGM devices.

What do you want to do?

I want to install and run the bridgeUSER-GUIDE.md. Step-by-step from zero (no terminal experience required). Covers install, login, start, troubleshooting, and keeping it running as a service.

I want to deploy it on a serverdeploy/README.md. systemd unit, install script, Nightscout + cloudflared docker-compose stack.

I want to read or modify the codedocs/ARCHITECTURE.md. Module map, data flow diagrams, OAuth deep-dive, error / retry semantics, test architecture, "where do I start" guide for new contributors.

I want to contribute a changeCONTRIBUTING.md. Workflow, ground rules, release process.

I want to understand the project's status and directionROADMAP.md. What's shipped, what's gated on what, what's out of scope.

I want to report a security issueSECURITY.md. Threat model, how to file a private advisory.

I want to see what changed recentlyCHANGELOG.md. Version history.

Quick start (one-liner)

If you already have Node 20+ and a CareLink account, this is the whole thing:

git clone https://github.com/NovaLux12/carelink-bridge.git
cd carelink-bridge
npm install && npm run build
cp .env.example .env       # then fill in CARELINK_USERNAME, CARELINK_PASSWORD, API_SECRET, NS
npm run doctor             # pre-flight check
npm run login              # one-time OAuth login
npm start                  # fetch loop

For the full walkthrough, including Node install, .env editing, the three login strategies, and troubleshooting, see USER-GUIDE.md.

Disclaimer

This project is for educational and informational purposes only. It is not FDA approved and should not be used to make medical decisions. It is not affiliated with or endorsed by Medtronic, and may violate their Terms of Service. Using it is at your own risk.

License

MIT

About

Community fork of domien-f/carelink-bridge — sends Medtronic CareLink pump + CGM data to Nightscout via OAuth2 mobile-app simulation. Maintained by @NovaLux12 while upstream is quiet.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages