Create a milestone with create_milestone

Goal: create a new milestone on a repository.

Prerequisites

• Write access to the target repository. Milestones are REST-only — GraphQL exposes them read-only, so this tool always goes through the REST milestones endpoint.

Steps

1. Call create_milestone, supplying only the fields you need:

   {
     "owner": "your-org",
     "repo": "your-repo",
     "title": "Q3 onboarding revamp",
     "description": "All onboarding-revamp work.",
     "dueOn": "2026-09-30T00:00:00Z"
   }

2. Read the response: { number, title, url, dueOn }.

Verify it worked

• Open the returned url and confirm the milestone exists with the title, description, and due date you specified.
• Call list_milestones and confirm it appears.

See also: tool reference.