{
  "slug": "github-mcp-server-projects-write-adds-project-and-iteration-field-methods-b72d48e287d6",
  "title": "github-mcp-server projects_write adds project and iteration field methods",
  "tools": [
    "github-mcp-server"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-06-08T10:51:27.000Z",
  "announced_at": "2026-06-08T10:51:27.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When configuring project work for a repository, create a GitHub ProjectsV2 project with `projects_write` using `create_project`, then add its iteration field with `create_iteration_field`. The documented creation methods take an account owner; `create_iteration_field` targets the created project by its project number.",
    "examples": [
      "projects_write({\"method\":\"create_project\",\"owner\":\"<owner>\",\"owner_type\":\"user|org\",\"title\":\"<project title>\"})",
      "projects_write({\"method\":\"create_iteration_field\",\"owner\":\"<owner>\",\"project_number\":<project number>,\"field_name\":\"<field name>\",\"iteration_duration\":<days>,\"start_date\":\"<YYYY-MM-DD>\"})"
    ],
    "gotchas": [
      "Version: v1.2.0",
      "method (required): Select `create_project` or `create_iteration_field`.",
      "owner (required): User or organization login that owns the project.",
      "owner_type (required): For `create_project`, specify `user` or `org`.",
      "title (required): Title of the project to create.",
      "project_number (required): Existing project number for `create_iteration_field`; omit for `create_project`.",
      "field_name (required): Name for the iteration field.",
      "iteration_duration (required): Iteration duration in days.",
      "start_date (required): Iteration start date in `YYYY-MM-DD` format.",
      "iterations: Custom iteration definitions; use when durations vary, breaks are needed, or specific titles are required. Otherwise GitHub creates three iterations using the duration and start date.",
      "Prerequisite: The `projects_write` tool requires the GitHub OAuth `project` scope.",
      "Prerequisite: The Projects toolset must be available in the MCP server."
    ]
  },
  "why_it_matters": "Create a GitHub project and an iteration field while configuring project work for a repository.",
  "sources": [
    "https://github.com/github/github-mcp-server/releases/tag/v1.2.0",
    "https://github.com/github/github-mcp-server/blob/v1.2.0/README.md"
  ],
  "rank": 0.9703,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "backfill-20261007",
    "verdict_id": "backfill-20261007:backfill-20261007-e40492a2714e2d09-1:gate",
    "evidence_hash": "43d4c305e4a4ab9c479c8e24606f5dc3ea5aabca55307d0f78e69f16e74a2cc8"
  },
  "review": {
    "draft_hash": "38d9c0f86b103d994c23d4e2c78471fd74bb3be2a65d47376c601713d142b9a6",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "backfill-20261007:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.97 >= 0.9; 2 needed) and Jev gave 0.72 (>= 0.6 needed)."
  }
}