Add basic project view management by zwick · Pull Request #2961 · github/github-mcp-server · GitHub

Summary

Adds basic ProjectV2 view lifecycle support to the consolidated Projects tools: list/get views plus create/update/delete with name, layout, and filter. Create supports visible fields by database ID or case-insensitive field name.

Why

Fixes github/planning-tracking#3776.

What changed

Added list_project_views and get_project_view with normalized output, pagination, and project-content IFC labels.
Added create_project_view, update_project_view, and delete_project_view; create uses the public REST endpoint and can resolve visible_field_names to the required database IDs.
Verify update/delete view ownership against the requested owner and project before mutation.
Added focused lifecycle tests, tool snapshots, Projects instructions, and generated README docs.

MCP impact

No tool or API changes
Tool schema or behavior changed - extends the existing consolidated Projects tools with five methods.
New tool added

Prompts tested (tool changes only)

"List the views in my user project."
"Create a table view filtered to status:Todo with Status and Assignees visible."
"Get the new view, rename it, switch it to board layout, and filter to assignee:@me."
"Clear the view filter, then delete the view and list the views again."

Validated through the built stdio MCP server against the public APIs without preview headers, including visible_field_names resolution, ownership-mismatch rejection, and final cleanup/read-back.

Security / limits

No security or limits impact
Auth / permissions considered - existing read:project and project scopes are unchanged, and mutations verify the view belongs to the requested project.
Data exposure, filtering, or token/size limits considered - read results use project-content IFC labels and list pagination remains capped at 50.

Tool renaming

I am renaming tools as part of this PR (e.g. a part of a consolidation effort)
- I have added the new tool aliases in deprecated_tool_aliases.go
I am not renaming tools as part of this PR

Lint & tests

Linted locally with ./script/lint
Tested locally with ./script/test

Docs

Not needed
Updated (README / docs / examples)

Pull request overview

Adds complete basic ProjectV2 view lifecycle support to the consolidated Projects tools.

Changes:

Adds list/get/create/update/delete view operations with pagination and IFC labeling.
Supports layouts, filters, visible fields, and ownership verification.
Adds tests, snapshots, instructions, and generated documentation.

Show a summary per file

File	Description
README.md	Documents view parameters.
pkg/github/toolset_instructions.go	Adds view workflow guidance.
pkg/github/projects.go	Implements view lifecycle operations.
pkg/github/projects_v2_test.go	Tests view behavior and authorization.
pkg/github/projects_test.go	Verifies updated tool schemas.
pkg/github/minimal_types.go	Adds normalized view output type.
pkg/github/__toolsnaps__/projects_write.snap	Updates write schema snapshot.
pkg/github/__toolsnaps__/projects_list.snap	Updates list schema snapshot.
pkg/github/__toolsnaps__/projects_get.snap	Updates get schema snapshot.

Review details

Files reviewed: 9/9 changed files
Comments generated: 0
Review effort level: Medium

Left two comments, otherwise lgtm!

owner is a login, but I think this endpoint requires the numeric user_id (octocat → 583231). If so, we should maybe resolve the user ID before building the URL and update the test? source

Great catch! This is actually an error in the docs. Verified against production:

POST /users/zwick/projectsV2/7/views
{"name":"Route evidence - login","layout":"table"}

HTTP 201
{"name":"Route evidence - login","project_url":"https://api.github.com/users/zwick/projectsV2/7"}

POST /users/1871037/projectsV2/7/views
{"name":"Route evidence - numeric ID","layout":"table"}

HTTP 404
{"message":"Not Found","status":"404"}

I'll see about getting these docs updated

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: c6f8ede6-efee-4191-900d-59a1bb0af000

Align the filter parameter with the nullable-parameter convention: omit to preserve, pass null to clear. Empty strings are now rejected rather than treated as a clear sentinel. The GraphQL and REST wire format is unchanged, since the API still clears a filter with an empty string. Also replace the "<nil>" string comparison in deleteProjectView with a direct nil check on the returned ID. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: c6f8ede6-efee-4191-900d-59a1bb0af000

zwick force-pushed the zwick-plan-project-v2-views branch from 861109f to 8fb2181 Compare July 27, 2026 17:26

zwick self-assigned this Jul 28, 2026

zwick marked this pull request as ready for review July 28, 2026 13:40

zwick requested a review from a team as a code owner July 28, 2026 13:40

Copilot AI review requested due to automatic review settings July 28, 2026 13:40

Copilot started reviewing on behalf of zwick July 28, 2026 13:41 View session

Copilot AI reviewed Jul 28, 2026

View reviewed changes

zwick marked this pull request as draft July 28, 2026 13:49

zwick force-pushed the zwick-plan-project-v2-views branch from cd30e93 to e519780 Compare July 28, 2026 14:26

zwick marked this pull request as ready for review July 28, 2026 15:19

zwick mentioned this pull request Jul 31, 2026

Add visible fields to project views #2988

Merged

13 tasks

zwick force-pushed the zwick-plan-project-v2-views branch 2 times, most recently from 4e7e2a5 to daba059 Compare August 7, 2026 12:41

tommaso-moro reviewed Aug 7, 2026

View reviewed changes

Comment thread pkg/github/projects.go Outdated

tommaso-moro reviewed Aug 7, 2026

View reviewed changes

zwick requested a review from tommaso-moro August 7, 2026 17:42

tommaso-moro approved these changes Aug 10, 2026

View reviewed changes

zwick and others added 5 commits August 12, 2026 08:38

Add basic project view management

ced0278

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: c6f8ede6-efee-4191-900d-59a1bb0af000

Harden project view mutations

52272fc

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: c6f8ede6-efee-4191-900d-59a1bb0af000

Resolve project view fields by name

8992ef3

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: c6f8ede6-efee-4191-900d-59a1bb0af000

Use caller-specific project field hints

b5d7459

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: c6f8ede6-efee-4191-900d-59a1bb0af000

zwick force-pushed the zwick-plan-project-v2-views branch from e949136 to b5d7459 Compare August 12, 2026 12:38

zwick merged commit d6cab97 into main Aug 12, 2026
19 checks passed

zwick deleted the zwick-plan-project-v2-views branch August 12, 2026 12:41

github-actions Bot mentioned this pull request Aug 20, 2026

[ca] Update CLI/MCP versions: Claude Code, Codex, GitHub MCP Server, MCP Gateway github/gh-aw#54168

Closed

Copilot AI mentioned this pull request Aug 21, 2026

Bump default CLI/MCP versions: Claude Code 2.1.237, Codex 0.148.0, GitHub MCP Server v1.10.0 github/gh-aw#54521

Merged

+              	case "org":
+              		endpoint = fmt.Sprintf("orgs/%s/projectsV2/%d/views", owner, projectNumber)
+              	case "user":
+              		endpoint = fmt.Sprintf("users/%s/projectsV2/%d/views", owner, projectNumber)

Add basic project view management by zwick · Pull Request #2961 · github/github-mcp-server · GitHub

Uh oh!

Add basic project view management - #2961

Add basic project view management#2961
zwick merged 5 commits into
mainfrom
zwick-plan-project-v2-views

zwick commented Jul 27, 2026 •
edited
Loading

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

tommaso-moro left a comment

Uh oh!

tommaso-moro Aug 7, 2026

Uh oh!

zwick Aug 7, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Add basic project view management by zwick · Pull Request #2961 · github/github-mcp-server · GitHub

Uh oh!

Add basic project view management - #2961

Add basic project view management#2961zwick merged 5 commits intomaingithub/github-mcp-server:mainfrom zwick-plan-project-v2-viewsgithub/github-mcp-server:zwick-plan-project-v2-viewsCopy head branch name to clipboard

Conversation

zwick commented Jul 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Why

What changed

MCP impact

Prompts tested (tool changes only)

Security / limits

Tool renaming

Lint & tests

Docs

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Review details

Uh oh!

Uh oh!

tommaso-moro left a comment

Choose a reason for hiding this comment

Uh oh!

tommaso-moro Aug 7, 2026

Choose a reason for hiding this comment

Uh oh!

zwick Aug 7, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Add basic project view management#2961
zwick merged 5 commits into
mainfrom
zwick-plan-project-v2-views

zwick commented Jul 27, 2026 •
edited
Loading