# Nightscout for Raycast

URL: https://www.raycast.com/zachsea/nightscout

> View Nightscout glucose readings and 24-hour trends, show the latest reading in the menu bar, and log treatments like insulin and carbs.

- Install: raycast://extensions/zachsea/nightscout
- Author: [zach](https://www.raycast.com/zachsea)
- Installs: 34
- Platforms: macOS
- Categories: Other
- Updated: 2026-11-17
- Source: https://github.com/raycast/extensions/tree/459326f4f557692a79246dba2d013746f56d724b/extensions/nightscout/

## Commands

- **View Glucose Readings**: View current glucose readings from your Nightscout instance
- **Show Glucose Reading**: Shows the latest glucose reading in root search and optionally in the menu bar
- **Search Entries and Treatments Log**: View all entries and treatments from your Nightscout instance
- **Menu Bar Glucose**: Shows the latest glucose reading in the menu bar
- **Add Treatment**: Add a new treatment (insulin, carbs, sensor change, etc.) to your Nightscout instance
- **Search Available Profiles**: View all profiles from your Nightscout instance

## README

<div align="center">
  <img
    src="https://github.com/raycast/extensions/raw/459326f4f557692a79246dba2d013746f56d724b/extensions/nightscout//media/nightscout_banner.png"
  />

  <h1>
    Nightscout
  </h1>

Fetches and displays glucose data from a Nightscout server instance.

  <p>
    <a
      href="https://github.com/raycast/extensions/blob/master/LICENSE"
    >
      <img
        src="https://img.shields.io/badge/License-MIT-yellow.svg"
        alt="raycast-extensions is released under the MIT license."
      />
    </a>
    <a href="https://twitter.com/intent/follow?screen_name=3zachm">
      <img
        src="https://img.shields.io/twitter/follow/3zachm.svg?label=3zachm"
        alt="Follow @3zachm"
      />
    </a>
  </p>
</div>


#### Features

- View current glucose readings in a dedicated view, root search, or the menu bar
- Visualize recent glucose trends (last 24 hours)
- Filter readings by time and glucose level
- View and add treatments (insulin, carbs, notes)
- Abides by your Nightscout profiles/configuration for glucose targets and units

#### Setup

Raycast will guide you through setting up the basic requirements. If your Nightscout instance is not publicly accessible, you will need to specify an access token in preferences. This is not marked as required since some instances are public, the extension will fail and prompt you if it is needed, providing the following instructions:

##### How to get your token

1. Sign in to your Nightscout instance
2. Go to `Admin Tools` → `Subjects - People, Devices, etc`
3. Create a subject with `readable` role (if you want to add treatments, also assign the `careportal` role)
4. Copy the access token and add it to extension preferences

##### Enable Background Refresh

> [!NOTE]
> You do not need to enable this specific background refresh command if you plan to use the menu bar item and don't care for the root search display, as that will also automatically refresh the cached readings in the background once per minute.

Enable background refresh for "Show Glucose Reading" command to see up-to-date readings in the root search. This will also ensure the other commands have fresh data when opened, running once every minute and caching results.

#### Disclaimer

As a friendly reminder, Nightscout's disclaimer also applies to the use of this extension:

> Nightscout is purely DIY software, built by patient volunteers or their caregivers, each to meet their own needs. All code is available online, and each user of Nightscout must decide for themselves whether they consider it safe. While all development takes place with safety as a first priority, the information shown on Nightscout cannot replace your primary, approved information source, i.e. the software or device provided with your glucose monitor.
>
>- Do not use any of the Nightscout information or code to make medical decisions.
>- There is no support or any warranty of any kind.
>- The quality and performance of the project is with you if you choose to use it.
>
> Regulatory authorities require each submitted product to have a legal manufacturer. Given there is no central organization responsible for Nightscout, it cannot be formally approved.

#### Contributing

I am newly diagnosed T1D, and I don't have access to many different Nightscout setups or devices, nor do I have a full understanding of my condition yet and how it relates to the use of Nightscout. If you have experience with more devices and treatment types, please feel free to open issues or PRs to improve the extension for everyone (please reach out too!).

Anything related to device status is currently missing, I will get around to this but if anyone else wants to tackle it, feel free :\)

#### Screenshots

##### Glucose Graph

[![Glucose Graph](https://github.com/raycast/extensions/raw/459326f4f557692a79246dba2d013746f56d724b/extensions/nightscout//metadata/nightscout-1.png)](metadata/nightscout-1.png)

##### Entries and Treatments

[![Entries and Treatments](https://github.com/raycast/extensions/raw/459326f4f557692a79246dba2d013746f56d724b/extensions/nightscout//metadata/nightscout-2.png)](metadata/nightscout-2.png)

##### Add Treatment

[![Add Treatment](https://github.com/raycast/extensions/raw/459326f4f557692a79246dba2d013746f56d724b/extensions/nightscout//metadata/nightscout-3.png)](metadata/nightscout-3.png)

[![Treatment Form](https://github.com/raycast/extensions/raw/459326f4f557692a79246dba2d013746f56d724b/extensions/nightscout//metadata/nightscout-4.png)](metadata/nightscout-4.png)

##### Profiles

[![Profiles](https://github.com/raycast/extensions/raw/459326f4f557692a79246dba2d013746f56d724b/extensions/nightscout//metadata/nightscout-5.png)](metadata/nightscout-5.png)

##### Menu Bar Glucose Reading

[![Current Glucose Reading](https://github.com/raycast/extensions/raw/459326f4f557692a79246dba2d013746f56d724b/extensions/nightscout//media/menubar_example.png)](media/menubar_example.png)
