MCP SERVERLet your assistant review GitHub Projects V2 and organize work by creating issues, updating project fields and removing project items.
GitHub Projects V2 MCP Server connects an assistant to projects owned by GitHub users and organizations. It brings project review and maintenance into your conversation: the assistant can read issues, pull requests and draft issues, create repository issues or project drafts, and change project item fields.
The server runs locally through your MCP client and accesses GitHub through its GraphQL API using a personal access token. Its write tools change live GitHub content, including creating repository issues and removing items from projects.
When you need to see what a project contains, ask your assistant to retrieve its issues, pull requests and draft issues. Filter by state or one custom field value to focus the review on a particular part of the workload.
Toolslist_get_get_
When work belongs in a project but exists only in a repository, have your assistant add the issue to the project. For newly identified work, it can create the repository issue first, giving you an issue that is also tracked in the project.
Toolscreate_add_
When an idea needs a place in your plan before it is ready for a repository issue, ask your assistant to create a draft issue directly in the project. The idea becomes a project item you can review alongside other work.
Toolscreate_
When a status, date or text detail changes, have your assistant update the corresponding project item field. It can inspect the project's fields and single-select options so the change uses an available field and value.
Toolsget_update_
When an item no longer belongs in a project, ask your assistant to remove it from that project. This lets you revise the project's contents as planning decisions change.
Toolsget_delete_
These tool definitions reflect the August 11, 2026 capture; your installed version may expose a different set.
Showing all 8
get_project_fieldsLists the fields available in a GitHub Project V2, including the available options for single-select fields.
get_project_itemsRetrieves issues, pull requests and draft issues from a GitHub Project V2. Results can be filtered by issue or pull request state, or by one custom field and value. Custom-field filtering supports single-select and iteration fields.
list_projectsLists GitHub Projects V2 owned by a specified user or organization.
add_issue_to_projectAdds an existing GitHub repository issue to a GitHub Project V2.
create_draft_issueCreates a draft issue directly in a GitHub Project V2, with a title and optional body.
create_issueCreates a GitHub issue in a specified repository, with a title and optional body.
delete_project_itemRemoves a specified item from a GitHub Project V2.
update_project_item_fieldChanges a field value on a GitHub Project V2 item. Accepts text, a date or an option ID for a single-select field.
No matching results.
Set up the local server in your MCP client and supply a GitHub personal access token with repo, project and read:org permissions.
Make sure uvx is available on PATH. Have a GitHub personal access token with the repo, project, and read:org permissions required by the project's setup instructions.
In Claude Desktop, open Settings > Developer > Edit Config to open its JSON configuration file.
Add the github-projects entry under mcpServers, keeping any existing server entries. Replace your_pat_here with your GitHub personal access token, then save the file. This sets GITHUB_TOKEN for the server through the configuration's env object.
claude_desktop_config.jsonJSON{
"mcpServers": {
"github-projects": {
"command": "uvx",
"args": [
"mcp-github-projects"
],
"env": {
"GITHUB_TOKEN": "your_pat_here"
}
}
}
}Completely quit Claude Desktop and reopen it to load the configuration and start the server.
Check the result
Confirm the server's tools appear
Click “Add files, connectors, and more /” at the bottom-left of the conversation input, then open Connectors > Manage connectors. Select github-projects and check that its tools, such as list_projects, are listed.
GitHub Projects V2 MCP Server setupConnect local MCP servers to Claude Desktop