Github Projects MCP Server

A Model Context Protocol (MCP) server that provides tools for managing GitHub Projects V2 through Claude and other MCP clients. This server uses the

Local serverstdio

What is the Github Projects MCP MCP server?

Github Projects MCP becomes available to MCP clients through the github projects mcp mcp server. A Model Context Protocol (MCP) server that provides tools for managing GitHub Projects V2 through Claude and other MCP clients. This server uses the GitHub GraphQL API for interacting with GitHub Projects V2.

What Github Projects MCP does

A Model Context Protocol (MCP) server that provides tools for managing GitHub Projects V2 through Claude and other MCP clients. This server uses the GitHub GraphQL API for interacting with GitHub Projects V2.

Key capabilities

  • List and view GitHub Projects V2 for users and organizations
  • Get project fields and items (issues, PRs, draft issues)
  • Create issues and add them to projects
  • Create draft issues directly in projects
  • Update project item field values
  • Delete items from projects

Tools it exposes

Once connected, the assistant can call these 9 tools directly:

  • list_projects — List GitHub Projects V2 for a given organization or user
  • get_project_fields — Get fields available in a GitHub Project V2
  • get_project_items — Get items in a GitHub Project V2 (supports filtering by
  • create_issue — Create a new GitHub issue
  • add_issue_to_project — Add an existing GitHub issue to a Project V2
  • update_project_item_field — Update a field value for a project item
  • create_draft_issue — Create a draft issue directly in a GitHub Project V2
  • delete_project_item — Delete an item from a GitHub Project V2
  • SetupCreate a GitHub Personal Access Token and give it the necessary permissions. The required permissions

Installing the github projects mcp mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Configuration

Before the server will start you need to supply one environment variable: GITHUB_TOKEN. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

Developer-tool servers are usually the first ones people connect, because they turn "help me with this code" into an assistant that can actually read the repo and act on it. Github Projects MCP sits in that group, and the shape of its toolset — list_projects, get_project_fields, get_project_items among others — tells you what it is really for. Worth comparing against the other developer tools servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • It will not start until its required credentials are present, so set those before wondering why the tools never appear.
  • With 9 tools exposed, expect a noticeable bump in prompt size — disable it in projects that never use Github Projects MCP.
  • Maintained by Arclio.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the github projects mcp mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
list_projectsList GitHub Projects V2 for a given organization or user
get_project_fieldsGet fields available in a GitHub Project V2
get_project_itemsGet items in a GitHub Project V2 (supports filtering by
create_issueCreate a new GitHub issue
add_issue_to_projectAdd an existing GitHub issue to a Project V2
update_project_item_fieldUpdate a field value for a project item
create_draft_issueCreate a draft issue directly in a GitHub Project V2
delete_project_itemDelete an item from a GitHub Project V2
Setup[Create a GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new) and give it the necessary permissions. The required permissions are: repo, project, and read:org.

How to install the Github Projects MCP MCP server

{
  "mcpServers": {
    "github-projects": {
      "command": "uvx",
      "args": [
        "mcp-github-projects"
      ],
      "env": {
        "GITHUB_TOKEN": "your_pat_here"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
GITHUB_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Github Projects MCP to list projects.
  • Use Github Projects MCP to get project fields.
  • Use Github Projects MCP to get project items.

Frequently asked questions

It connects Github Projects MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 9 tools (list_projects, get_project_fields, get_project_items, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Github Projects MCP directly.