feat: milestone read write search CRUD operations

README.md

@@ -1101,6 +1101,11 @@ Possible options:
   - `owner`: Repository owner (string, required)
   - `repo`: Repository name (string, required)
 
+- **get_milestone** - Get repository milestone.
+  - `milestone_number`: Milestone number to fetch (number, required)
+  - `owner`: Repository owner (username or organization name) (string, required)
+  - `repo`: Repository name (string, required)
+
 - **get_release_by_tag** - Get a release by tag name
   - `owner`: Repository owner (string, required)
   - `repo`: Repository name (string, required)
@@ -1125,6 +1130,15 @@ Possible options:
   - `repo`: Repository name (string, required)
   - `sha`: Commit SHA, branch or tag name to list commits of. If not provided, uses the default branch of the repository. If a commit SHA is provided, will list commits up to that SHA. (string, optional)
 
+- **list_milestones** - List repository milestones.
+  - `direction`: Sort direction: asc or desc (string, optional)
+  - `owner`: Repository owner (username or organization name) (string, required)
+  - `page`: Page number (1-indexed) (number, optional)
+  - `per_page`: Results per page (max 100) (number, optional)
+  - `repo`: Repository name (string, required)
+  - `sort`: Sort field: due_on or completeness (string, optional)
+  - `state`: Filter by state: open, closed, or all (string, optional)
+
 - **list_releases** - List releases
   - `owner`: Repository owner (string, required)
   - `page`: Page number for pagination (min 1) (number, optional)
@@ -1137,6 +1151,16 @@ Possible options:
   - `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
   - `repo`: Repository name (string, required)
 
+- **milestone_write** - Write operations on repository milestones.
+  - `description`: Milestone description (string, optional)
+  - `due_on`: Due date in ISO-8601 date (YYYY-MM-DD) or RFC3339 timestamp (string, optional)
+  - `method`: Operation to perform: 'create', 'update', or 'delete' (string, required)
+  - `milestone_number`: Milestone number to update or delete (number, optional)
+  - `owner`: Repository owner (username or organization name) (string, required)
+  - `repo`: Repository name (string, required)
+  - `state`: Milestone state: 'open' or 'closed' (string, optional)
+  - `title`: Milestone title (required for create) (string, optional)
+
 - **push_files** - Push files to repository
   - `branch`: Branch to push to (string, required)
   - `files`: Array of file objects to push, each object with path (string) and content (string) (object[], required)
@@ -1151,6 +1175,14 @@ Possible options:
   - `query`: Search query using GitHub's powerful code search syntax. Examples: 'content:Skill language:Java org:github', 'NOT is:archived language:Python OR language:go', 'repo:github/github-mcp-server'. Supports exact matching, language filters, path filters, and more. (string, required)
   - `sort`: Sort field ('indexed' only) (string, optional)
 
+- **search_milestones** - Search repository milestones.
+  - `owner`: Repository owner (username or organization name) (string, required)
+  - `page`: Page number (1-indexed) (number, optional)
+  - `per_page`: Results per page (max 100) (number, optional)
+  - `query`: Text to search for in milestone title or description (string, required)
+  - `repo`: Repository name (string, required)
+  - `state`: Filter by state: open, closed, or all (default: open) (string, optional)
+
 - **search_repositories** - Search repositories
   - `minimal_output`: Return minimal repository information (default: true). When false, returns full GitHub API repository objects. (boolean, optional)
   - `order`: Sort order (string, optional)

pkg/github/__toolsnaps__/get_milestone.snap

@@ -0,0 +1,30 @@
+{
+  "annotations": {
+    "readOnlyHint": true,
+    "title": "Get repository milestone."
+  },
+  "description": "Get a milestone by number.",
+  "inputSchema": {
+    "type": "object",
+    "required": [
+      "owner",
+      "repo",
+      "milestone_number"
+    ],
+    "properties": {
+      "milestone_number": {
+        "type": "number",
+        "description": "Milestone number to fetch"
+      },
+      "owner": {
+        "type": "string",
+        "description": "Repository owner (username or organization name)"
+      },
+      "repo": {
+        "type": "string",
+        "description": "Repository name"
+      }
+    }
+  },
+  "name": "get_milestone"
+}

pkg/github/__toolsnaps__/list_milestones.snap

@@ -0,0 +1,58 @@
+{
+  "annotations": {
+    "readOnlyHint": true,
+    "title": "List repository milestones."
+  },
+  "description": "List milestones for a repository.",
+  "inputSchema": {
+    "type": "object",
+    "required": [
+      "owner",
+      "repo"
+    ],
+    "properties": {
+      "direction": {
+        "type": "string",
+        "description": "Sort direction: asc or desc",
+        "enum": [
+          "asc",
+          "desc"
+        ]
+      },
+      "owner": {
+        "type": "string",
+        "description": "Repository owner (username or organization name)"
+      },
+      "page": {
+        "type": "number",
+        "description": "Page number (1-indexed)"
+      },
+      "per_page": {
+        "type": "number",
+        "description": "Results per page (max 100)"
+      },
+      "repo": {
+        "type": "string",
+        "description": "Repository name"
+      },
+      "sort": {
+        "type": "string",
+        "description": "Sort field: due_on or completeness",
+        "enum": [
+          "due_on",
+          "completeness"
+        ]
+      },
+      "state": {
+        "type": "string",
+        "description": "Filter by state: open, closed, or all",
+        "enum": [
+          "open",
+          "closed",
+          "all"
+        ]
+      }
+    }
+  },
+  "name": "list_milestones"
+}

pkg/github/__toolsnaps__/milestone_write.snap

@@ -0,0 +1,58 @@
+{
+  "annotations": {
+    "title": "Write operations on repository milestones."
+  },
+  "description": "Create, update, or delete milestones in a repository.",
+  "inputSchema": {
+    "type": "object",
+    "required": [
+      "method",
+      "owner",
+      "repo"
+    ],
+    "properties": {
+      "description": {
+        "type": "string",
+        "description": "Milestone description"
+      },
+      "due_on": {
+        "type": "string",
+        "description": "Due date in ISO-8601 date (YYYY-MM-DD) or RFC3339 timestamp"
+      },
+      "method": {
+        "type": "string",
+        "description": "Operation to perform: 'create', 'update', or 'delete'",
+        "enum": [
+          "create",
+          "update",
+          "delete"
+        ]
+      },
+      "milestone_number": {
+        "type": "number",
+        "description": "Milestone number to update or delete"
+      },
+      "owner": {
+        "type": "string",
+        "description": "Repository owner (username or organization name)"
+      },
+      "repo": {
+        "type": "string",
+        "description": "Repository name"
+      },
+      "state": {
+        "type": "string",
+        "description": "Milestone state: 'open' or 'closed'",
+        "enum": [
+          "open",
+          "closed"
+        ]
+      },
+      "title": {
+        "type": "string",
+        "description": "Milestone title (required for create)"
+      }
+    }
+  },
+  "name": "milestone_write"
+}

pkg/github/__toolsnaps__/search_milestones.snap

@@ -0,0 +1,47 @@
+{
+  "annotations": {
+    "readOnlyHint": true,
+    "title": "Search repository milestones."
+  },
+  "description": "Search milestones for a repository.",
+  "inputSchema": {
+    "type": "object",
+    "required": [
+      "owner",
+      "repo",
+      "query"
+    ],
+    "properties": {
+      "owner": {
+        "type": "string",
+        "description": "Repository owner (username or organization name)"
+      },
+      "page": {
+        "type": "number",
+        "description": "Page number (1-indexed)"
+      },
+      "per_page": {
+        "type": "number",
+        "description": "Results per page (max 100)"
+      },
+      "query": {
+        "type": "string",
+        "description": "Text to search for in milestone title or description"
+      },
+      "repo": {
+        "type": "string",
+        "description": "Repository name"
+      },
+      "state": {
+        "type": "string",
+        "description": "Filter by state: open, closed, or all (default: open)",
+        "enum": [
+          "open",
+          "closed",
+          "all"
+        ]
+      }
+    }
+  },
+  "name": "search_milestones"
+}