Github Projects Mcp Server

Name: Github Projects Mcp Server
Author: Arclio

@Arclio

Github Projects Mcp Server について

A Model Context Protocol (MCP) server that provides tools for managing GitHub Projects V2. This server uses the GitHub GraphQL API for interacting with GitHub Projects V2 for project board management and tracking tickets/issues.

#github-mcp #github-projects #mcp-server

基本情報

カテゴリ

バージョン管理

トランスポート

stdio

公開者

Arclio

投稿者

Hillary

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

List GitHub Projects V2 for a given organization or user. Args: owner: The GitHub organization or user name Returns: A formatted string with project details

Get fields available in a GitHub Project V2, including options for SingleSelect fields. Args: owner: The GitHub organization or user name project_number: The project number Returns: A formatted string with field details.

Get items in a GitHub Project V2. Can filter by state OR a single custom field=value. Args: owner: The GitHub organization or user name project_number: The project number limit: Maximum number of items to return (default: 50). When filtering, the system automatically fetches more items to improve efficiency. state: Optional state filter (e.g., "OPEN", "CLOSED"). Applies to Issues/PRs. filter_field_name: Optional custom field name to filter by (e.g., "Status"). Currently supports SingleSelect and Iteration fields. filter_field_value: Optional custom field value to filter by (e.g., "In Development"). Uses case-insensitive matching. cursor: Optional cursor for pagination. Use value from previous results to get next page. Returns: A formatted string with item details.

Create a new GitHub issue. Args: owner: The GitHub organization or user name repo: The repository name title: The issue title body: The issue body (optional) Returns: A formatted string with the created issue details

Add an existing GitHub issue to a Project V2. Args: owner: The GitHub organization or user name that owns the project project_number: The project number issue_owner: The owner of the repository containing the issue issue_repo: The repository name containing the issue issue_number: The issue number Returns: A formatted string confirming the addition

Update a field value for a project item. Args: owner: The GitHub organization or user name project_number: The project number item_id: The ID of the item to update field_id: The ID of the field to update field_value: The new value for the field (text, date, or option ID for single select) Returns: A confirmation message

Create a draft issue directly in a GitHub Project V2. Args: owner: The GitHub organization or user name project_number: The project number title: The draft issue title body: The draft issue body (optional) Returns: A confirmation message with the new draft issue details

Delete an item from a GitHub Project V2. Args: owner: The GitHub organization or user name project_number: The project number item_id: The ID of the item to delete Returns: A confirmation message

概要

What is Github Projects Mcp Server?

It is a Model Context Protocol (MCP) server that provides tools for managing GitHub Projects V2 through Claude and other MCP clients. It uses the GitHub GraphQL API to interact with GitHub Projects V2.

How to use Github Projects Mcp Server?

Configure the server in your MCP client (e.g., Claude Desktop) using either the published package (uvx mcp-github-projects) or by running from source. Set a GitHub Personal Access Token with repo, project, and read:org scopes as the GITHUB_TOKEN environment variable. Example configuration via uvx is provided in the README.

Key features of Github Projects Mcp Server

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

Use cases of Github Projects Mcp Server

Manage project boards through natural language conversations with an AI
Automate adding issues to projects as they are created
Update project field values (e.g., status, priority) without a UI
Quickly fetch project structure and item details

FAQ from Github Projects Mcp Server

What permissions are required for the GitHub token?

The token must have the repo, project, and read:org scopes.

Can I use this server with any MCP client?

Yes, the server works with any MCP client, such as Claude Desktop.

How do I install the server?

You can either run the published package directly using uvx mcp-github-projects or clone the repository and install from source with uv pip install -e ..