Skip to main content
Glama

get_activities

Read-onlyIdempotent

Get a coaching overview of the user's completed training in a date range: strength sessions, runs, and rides, newest first. Each activity has an activity_id, kind, name, date, days_ago, and minutes. Strength adds exercise names, working set count, and primary muscles trained; runs and rides add distance, pace or speed, average heart rate, heart rate zone load, and hard minutes, in the user's units. totals summarizes every activity in the range by kind.

Args: start_date: Start of the range (YYYY-MM-DD). Defaults to 30 days before end_date. end_date: End of the range (YYYY-MM-DD). Defaults to today. kinds: Optional subset of strength, run, ride. Defaults to all. limit: Max activities listed (default 40, max 100). totals still cover the whole range.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_activities"
  }
}

Input Schema

NameRequiredDescriptionDefault
kindsNoWhich kinds to include. Defaults to all.
limitNoMax activities listed (default 40, max 100)
end_dateNoEnd of the range (YYYY-MM-DD). Defaults to today.
start_dateNoStart of the range (YYYY-MM-DD). Defaults to 30 days before end_date.

Output Schema

NameRequiredDescriptionDefault
rangeYes
totalsYesEvery activity in the range, by kind, including any beyond the limit, unless totals_partial is true.
truncatedNoTrue when the range holds more activities than the list returns.
activitiesYes
totals_partialNoTrue when the range holds more activities than one call reads, so totals cover only the newest ones. Narrow the date range for complete totals.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed24 schema fields changed
    • removedInput schema / properties / detail
      Removed value: -{
      -  "description": "'summary' = names/dates only; 'full' = per-set detail (default)",
      -  "enum": [
      -    "summary",
      -    "full"
      -  ],
      -  "type": "string"
      -}
    • changedInput schema / properties / end_date / description
      Previous value: -"End of date range (YYYY-MM-DD). Defaults to today."New value: +"End of the range (YYYY-MM-DD). Defaults to today."
    • addedInput schema / properties / kinds
      Added value: +{
      +  "description": "Which kinds to include. Defaults to all.",
      +  "items": {
      +    "enum": [
      +      "strength",
      +      "run",
      +      "ride"
      +    ],
      +    "type": "string"
      +  },
      +  "minItems": 1,
      +  "type": "array"
      +}
    • changedInput schema / properties / limit / description
      Previous value: -"Max results (default 10, max 100)"New value: +"Max activities listed (default 40, max 100)"
    • changedInput schema / properties / start_date / description
      Previous value: -"Start of date range (YYYY-MM-DD). Defaults to 30 days ago."New value: +"Start of the range (YYYY-MM-DD). Defaults to 30 days before end_date."
    • removedInput schema / properties / workout_name
      Removed value: -{
      -  "description": "Optional filter by workout name",
      -  "type": "string"
      -}
    • addedOutput schema / properties / activities / items / properties / activity_id
      Added value: +{
      +  "description": "Identifies the activity in tool calls. Never show it to the user.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / activities / items / properties / days_ago
      Added value: +{
      +  "description": "Local calendar days between local_date and today (0 = today). Present with local_date.",
      +  "type": "number"
      +}
    • removedOutput schema / properties / activities / items / properties / duration_seconds
      Removed value: -{
      -  "type": "number"
      -}
    • addedOutput schema / properties / activities / items / properties / endurance
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Runs and rides only.",
      +  "properties": {
      +    "avg_hr": {
      +      "type": "number"
      +    },
      +    "avg_speed": {
      +      "description": "Rides: average moving speed in speed_unit.",
      +      "type": "number"
      +    },
      +    "distance": {
      +      "type": "number"
      +    },
      +    "distance_unit": {
      +      "enum": [
      +        "mi",
      +        "km"
      +      ],
      +      "type": "string"
      +    },
      +    "hard_minutes": {
      +      "description": "Minutes in heart rate zones 4 and 5.",
      +      "type": "number"
      +    },
      +    "indoor": {
      +      "type": "boolean"
      +    },
      +    "intervals": {
      +      "description": "True when the laps alternate work and rest.",
      +      "type": "boolean"
      +    },
      +    "pace": {
      +      "description": "Runs: average moving pace as m:ss per distance_unit.",
      +      "type": "string"
      +    },
      +    "speed_unit": {
      +      "enum": [
      +        "mph",
      +        "km/h"
      +      ],
      +      "type": "string"
      +    },
      +    "zone_load": {
      +      "description": "Heart rate zone load: minutes in each of the user's own zones 1 to 5 weighted 1 to 5. Compare it with this user's other sessions, not with other people.",
      +      "type": "number"
      +    }
      +  },
      +  "required": [
      +    "distance_unit"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / activities / items / properties / exercise_names / description
      Previous value: -"Present in summary mode"New value: +"Strength only."
    • removedOutput schema / properties / activities / items / properties / exercises
      Removed value: -{
      -  "description": "Present in full mode",
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "name": {
      -        "type": "string"
      -      },
      -      "notes": {
      -        "type": "string"
      -      },
      -      "rest_mode": {
      -        "enum": [
      -          "timed",
      -          "off",
      -          "lap"
      -        ],
      -        "type": "string"
      -      },
      -      "rest_seconds": {
      -        "type": "number"
      -      },
      -      "rpe": {
      -        "type": "number"
      -      },
      -      "sets": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "percentage_of_tm": {
      -              "type": "number"
      -            },
      -            "reps": {
      -              "type": "number"
      -            },
      -            "rpe": {
      -              "type": "number"
      -            },
      -            "seconds": {
      -              "type": "number"
      -            },
      -            "set_type": {
      -              "type": "string"
      -            },
      -            "target_type": {
      -              "type": "string"
      -            },
      -            "weight": {
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "set_type",
      -            "target_type",
      -            "weight"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "superset": {
      -        "type": "number"
      -      },
      -      "target_sets": {
      -        "items": {
      -          "$ref": "#/properties/activities/items/properties/exercises/items/properties/sets/items"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "name",
      -      "sets"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • addedOutput schema / properties / activities / items / properties / kind
      Added value: +{
      +  "enum": [
      +    "strength",
      +    "run",
      +    "ride"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / properties / activities / items / properties / local_date / description
      Previous value: -"The calendar date (YYYY-MM-DD) this session happened on, in the user's local timezone. Present only when the client reported a timezone. When present, quote it rather than converting started_at yourself."New value: +"The calendar date (YYYY-MM-DD) of the activity in the user's local timezone. Present only when the client reported a timezone; quote it rather than converting started_at."
    • addedOutput schema / properties / activities / items / properties / minutes
      Added value: +{
      +  "description": "Session length; moving time for runs and rides.",
      +  "type": "number"
      +}
    • addedOutput schema / properties / activities / items / properties / muscles
      Added value: +{
      +  "description": "Strength only: primary muscles that got working sets.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / activities / items / properties / started_at / description
      Previous value: -"The instant the session started, as an ISO 8601 UTC timestamp."New value: +"The instant the activity started, as an ISO 8601 UTC timestamp."
    • addedOutput schema / properties / activities / items / properties / working_sets
      Added value: +{
      +  "description": "Strength only.",
      +  "type": "number"
      +}
    • changedOutput schema / properties / activities / items / required
      Previous value: -[
      -  "name"
      -]New value: +[
      +  "activity_id",
      +  "kind",
      +  "name"
      +]
    • addedOutput schema / properties / range
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "end_date": {
      +      "type": "string"
      +    },
      +    "start_date": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / totals
      Added value: +{
      +  "description": "Every activity in the range, by kind, including any beyond the limit, unless totals_partial is true.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "distance": {
      +        "description": "Runs and rides, in distance_unit.",
      +        "type": "number"
      +      },
      +      "distance_unit": {
      +        "enum": [
      +          "mi",
      +          "km"
      +        ],
      +        "type": "string"
      +      },
      +      "hard_minutes": {
      +        "type": "number"
      +      },
      +      "kind": {
      +        "enum": [
      +          "strength",
      +          "run",
      +          "ride"
      +        ],
      +        "type": "string"
      +      },
      +      "last_local_date": {
      +        "type": "string"
      +      },
      +      "last_started_at": {
      +        "type": "string"
      +      },
      +      "minutes": {
      +        "type": "number"
      +      },
      +      "sessions": {
      +        "type": "number"
      +      },
      +      "working_sets": {
      +        "description": "Strength only.",
      +        "type": "number"
      +      },
      +      "zone_load": {
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "sessions",
      +      "minutes"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / totals_partial
      Added value: +{
      +  "description": "True when the range holds more activities than one call reads, so totals cover only the newest ones. Narrow the date range for complete totals.",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / truncated
      Added value: +{
      +  "description": "True when the range holds more activities than the list returns.",
      +  "type": "boolean"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "activities"
      -]New value: +[
      +  "range",
      +  "totals",
      +  "activities"
      +]
  2. First observed

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, non-destructive and closed-world, so the safety profile is covered. The description adds genuinely useful behavior beyond that: newest-first ordering, unit-localized distance/pace/speed, and the important nuance that limit caps the listed activities while totals still cover the whole range.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the purpose and scope, then return shape, then a compact Args block. The enumeration of per-kind return fields is somewhat long but each item is decision-relevant for a coaching tool; little could be cut without losing signal.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a four-parameter read tool with an output schema, the description covers scope, defaults, ordering, per-kind payload differences, and the totals semantics. Nothing an agent needs to call it correctly is missing, and the return-field detail is a bonus rather than a gap-filler.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline would be 3, but the description adds meaning not present in the schema — notably that limit only truncates the listing and totals remain range-wide, plus that start_date defaults relative to end_date. It restates the other defaults, which is mild redundancy but reinforces correct pairing.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource — a coaching overview of completed training (strength sessions, runs, rides) within a date range — and specifies ordering (newest first). It does not distinguish itself from the sibling get_activity_detail, so an agent must infer that the detail tool covers a single activity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied by 'coaching overview' and 'totals summarizes every activity in the range', which signals a multi-activity summary rather than a single-record fetch. However, there is no explicit when-to-use/when-not guidance and no named alternative such as get_activity_detail for drilling into one activity.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources