Skip to content

List milestones with list_milestones

Goal: retrieve a repository’s milestones, filtered by state.

  • Read access to the target repository.
  1. Call list_milestones:

    { "owner": "your-org", "repo": "your-repo", "state": "open" }

    Omit state to default to open; pass "closed" or "all" for other views.

  2. Read the response — an array of { number, title, url, dueOn }.

  • Cross-check the returned titles/numbers against the repository’s Milestones page in the browser, filtered the same way.
  • An empty array is a valid result (no milestones match the requested state) — it’s not an error condition.

See also: tool reference.