# projects_write

Add, update, or delete project items, or create status updates in a GitHub Project.

Agent View of the PolicyLayer registry record for `projects_write`. HTML page: https://policylayer.com/tools/github/projects-write

## Facts

- Tool: `projects_write`
- Server: GitHub (`oci:ghcr.io/github/github-mcp-server:1.3.0`) — https://policylayer.com/tools/github.md
- Homepage: https://github.com/github/github-mcp-server
- Risk category: Destructive (Critical risk)
- Registry record: grade D, identity verified
- Server auth posture: gated
- Server rate-limited: no
- Parameters: 12
- Recommended policy verdict: Hidden

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `body` | string | no | The body of the status update (markdown). Used for 'create_project_status_update' method. |
| `owner` | string | no | The project owner (user or organization login). The name is not case sensitive. |
| `method` | string | no | The method to execute |
| `status` | string | no | The status of the project. Used for 'create_project_status_update' method. |
| `item_id` | number | no | The project item ID. Required for 'update_project_item' and 'delete_project_item' methods. |
| `item_repo` | string | no | The name of the repository containing the issue or pull request. Required for 'add_project_item' method. |
| `item_type` | string | no | The item's type, either issue or pull_request. Required for 'add_project_item' method. |
| `item_owner` | string | no | The owner (user or organization) of the repository containing the issue or pull request. Required for 'add_project_item' method. |
| `owner_type` | string | no | Owner type (user or org). If not provided, will be automatically detected. |
| `start_date` | string | no | The start date of the status update in YYYY-MM-DD format. Used for 'create_project_status_update' method. |
| `target_date` | string | no | The target date of the status update in YYYY-MM-DD format. Used for 'create_project_status_update' method. |
| `issue_number` | number | no | The issue number (use when item_type is 'issue' for 'add_project_item' method). Provide either issue_number or pull_request_number. |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "projects_write",
    "arguments": {}
  }
}
```

## Why projects_write is rated Critical

The tool explicitly supports 'delete project items', which is an irreversible destructive operation. Per the rules, when a tool spans categories, the most severe applies — Destructive takes precedence over Write. Misuse could remove project tracking data across an organization's GitHub Projects.

From the tool's own definition: "Add, update, or delete project items, or create status updates in a GitHub Project."

Risk signals: Accepts raw HTML/template content (body) · High parameter count (15 properties)

## Use case

AI agents call projects_write to permanently remove resources in GitHub, typically in cleanup and lifecycle workflows. It does its job in a single call, and there is no undo.

## Recommended policy (PolicyLayer)

Verdict: **Hidden**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches GitHub:

```json
{
  "version": "1",
  "default": "deny",
  "hide": [
    "projects_write"
  ]
}
```

## Other tools on GitHub (85)

- `delete_file` — Destructive — https://policylayer.com/tools/github/delete-file.md
- `actions_run_trigger` — Execute — https://policylayer.com/tools/github/actions-run-trigger.md
- `assign_copilot_to_issue` — Execute — https://policylayer.com/tools/github/assign-copilot-to-issue.md
- `actions_get` — Read — https://policylayer.com/tools/github/actions-get.md
- `actions_list` — Read — https://policylayer.com/tools/github/actions-list.md
- `get_code_scanning_alert` — Read — https://policylayer.com/tools/github/get-code-scanning-alert.md
- `get_commit` — Read — https://policylayer.com/tools/github/get-commit.md
- `get_copilot_job_status` — Read — https://policylayer.com/tools/github/get-copilot-job-status.md
- `get_copilot_space` — Read — https://policylayer.com/tools/github/get-copilot-space.md
- `get_dependabot_alert` — Read — https://policylayer.com/tools/github/get-dependabot-alert.md
- `get_discussion` — Read — https://policylayer.com/tools/github/get-discussion.md
- `get_discussion_comments` — Read — https://policylayer.com/tools/github/get-discussion-comments.md
- `get_file_contents` — Read — https://policylayer.com/tools/github/get-file-contents.md
- `get_gist` — Read — https://policylayer.com/tools/github/get-gist.md
- `get_global_security_advisory` — Read — https://policylayer.com/tools/github/get-global-security-advisory.md
- `get_job_logs` — Read — https://policylayer.com/tools/github/get-job-logs.md
- `get_label` — Read — https://policylayer.com/tools/github/get-label.md
- `get_latest_release` — Read — https://policylayer.com/tools/github/get-latest-release.md
- `get_me` — Read — https://policylayer.com/tools/github/get-me.md
- `get_notification_details` — Read — https://policylayer.com/tools/github/get-notification-details.md
- `get_release_by_tag` — Read — https://policylayer.com/tools/github/get-release-by-tag.md
- `get_repository_tree` — Read — https://policylayer.com/tools/github/get-repository-tree.md
- `get_secret_scanning_alert` — Read — https://policylayer.com/tools/github/get-secret-scanning-alert.md
- `get_tag` — Read — https://policylayer.com/tools/github/get-tag.md
- `get_team_members` — Read — https://policylayer.com/tools/github/get-team-members.md
- `get_teams` — Read — https://policylayer.com/tools/github/get-teams.md
- `github_support_docs_search` — Read — https://policylayer.com/tools/github/github-support-docs-search.md
- `issue_read` — Read — https://policylayer.com/tools/github/issue-read.md
- `list_branches` — Read — https://policylayer.com/tools/github/list-branches.md
- `list_code_scanning_alerts` — Read — https://policylayer.com/tools/github/list-code-scanning-alerts.md
- …and 55 more: https://policylayer.com/tools/github.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=github · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/github