Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OURA_PATNoYour Oura Personal Access Token
OURA_PAT_FILENoPath to a file containing your Oura Personal Access Token (mode 600 recommended)

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
oura_collectionsA

The 19 Oura collections, what each one carries and which parameters it takes.

Use it before oura_query if you are unsure of the exact name.

oura_queryA

Fetches a COMPLETE Oura collection over the requested range.

Follows pagination to the end: Oura returns next_token and whoever doesn't chase it receives the first page with nothing saying so. One local day of heartrate is 1,231 samples across 2 pages; a month, ~37,000.

The range is INCLUSIVE on both ends: equal start and end return that day. Oura does not behave that way — some collections exclude the last day and others don't, and workout is skewed to UTC — but that is corrected here.

Date-range collections use YYYY-MM-DD. heartrate and ring_battery_level use ISO 8601 with time. personal_info and ring_configuration take no range.

oura_todayA

Last night's sleep and today's readiness, with the days before them.

ONE CALL INSTEAD OF FOUR, and that is the whole of it. «How did I sleep?» is the most common question there is, and answering it well means today's two records plus enough history to know whether they are unusual — which was four round trips through oura_query and four chances to stop early.

IT COMPUTES NOTHING. No average, no delta, no «your HRV is up 12%». The records come back raw and the comparison happens where the method can be cited. That is not an omission: across nine years of real data, three out of four changes between consecutive measurements fall inside the metric's own normal swing, so a server that hands over a percentage without saying how much the metric wanders on its own is manufacturing a signal.

today is very often empty and that is not an error: the ring syncs when it feels like it, and the current day is the one most likely to be missing. missing names whichever came back empty, so «no data yet» is never mistaken for «nothing happened».

oura_checkA

Self-check: is there a credential, and does Oura respond? Exposing nothing.

Returns neither the token nor any health value. It reports the token's LENGTH, never the token: diagnostic messages are the ones most often copied into chats and issues.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
Oura collection catalogThe 19 collections, what each carries and which parameters it takes. Static: no network, no credentials, no health data.

TDQS

A4.4/5.0

Scored across 4 tools

Disambiguation4/5

Each tool has a distinct role: oura_today is a composite sleep/readiness shortcut, oura_query is the general-purpose collection fetcher, oura_collections is discovery, and oura_check is diagnostics. oura_today partially overlaps with oura_query (which can also fetch sleep/readiness), but the descriptions clearly frame today as a convenience wrapper, so misselection risk is low.

Naming Consistency5/5

All four tools share a uniform oura_ prefix followed by a single lowercase snake_case word (today, check, collections, query). The convention is applied without deviation, making the set easy to scan and predict.

Tool Count4/5

Four tools is on the lean side but each earns its place: a diagnostic, a discovery catalog, a general query, and a composite shortcut. A generic query tool absorbs most remaining coverage, so nothing feels padded or redundant.

Completeness5/5

The surface covers the read-only Oura domain well: catalog discovery (oura_collections), generic full-pagination retrieval across all collections (oura_query), a common composite case (oura_today), and credential/connectivity validation (oura_check). No obvious read-path gaps remain for the stated purpose.

Maintenance

ActivityMaintained
ResponsivenessNo issues