list_timers

List timers in your user scope, a team you own, or a repo you can read.

New to deferred work? Read the Timers and future signals guide or follow recurring repository maintenance.

Scope and access

User-scoped timers are private to the authenticated user.
Team-scoped timers can only be listed or managed by a team owner.
Repo-scoped timers can be listed and fetched by users with repo read access; creating, updating, or deleting one requires maintainer access.
A timer UUID is only reachable through its owning user, team, or repo scope.

Tool

list_timers

Authenticated

Input

{
  "repo": "teams/platform/website",
  "status": "active",
  "limit": 20
}

Omit both team and repo for your own timers. They are mutually exclusive. status accepts active, paused, completed, or cancelled. limit defaults to 20 and is clamped to 1-100.

Result

{
  "timers": [
    { "uuid": "8f7a2ba9-8a67-4a56-a8e8-0fe9f26717f6", "status": "active", "...": "..." }
  ],
  "has_more": false
}

Timer result

{
  "uuid": "8f7a2ba9-8a67-4a56-a8e8-0fe9f26717f6",
  "message": "Review the release checklist",
  "scope": "user",
  "schedule_kind": "interval",
  "schedule": "Mon, Tue, Wed, Thu, Fri at 09:00 (America/New_York)",
  "status": "active",
  "timezone": "America/New_York",
  "next_run_at": "2026-08-24T13:00:00+00:00",
  "last_run_at": null,
  "run_count": 0
}