GitHub Projects MCP Server

An MCP (Model Context Protocol) server that enables AI agents to create and manage Agile Sprint-based projects using GitHub Projects.

Features

GitHub Projects v2 API: Full support for GitHub's GraphQL Projects v2 API
GitHub Issues: Create, read, and update GitHub issues
GitHub Repositories: Fetch repository details
Type Safety: Built with TypeScript for maximum type safety

Installation

Installing via Smithery

To install GitHub Projects MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install taylor-lindores-reeves/mcp-github-projects --client claude

Usage

Manual Installation

Clone this repository:
git clone https://github.com/taylor-lindores-reeves/mcp-github-projects.git cd mcp-github-projects
Install dependencies:
bun install
Create a .env file with your GitHub token:
GITHUB_TOKEN=your_github_personal_access_token GITHUB_OWNER=your_github_username
Build the server:
bun run build
Configure your MCP client with the following settings:

{
  "mcpServers": {
    "GitHubProjects": {
      "command": "bun",
      "args": [
        "/path/to/your/directory/mcp-github-projects-main/build/index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token",
        "GITHUB_OWNER": "your_github_username_or_org"
      }
    }
  }
}

Environment Variables

GITHUB_TOKEN: GitHub Personal Access Token with appropriate permissions
GITHUB_OWNER: GitHub username or organization name

GitHub Token Permissions

This MCP server requires a GitHub Personal Access Token (classic) with the following permissions:

project - Full control of projects
read:project - Read access of projects
repo - Full control of private repositories
repo:status - Access commit status
repo_deployment - Access deployment status
public_repo - Access public repositories
repo:invite - Access repository invitations
security_events - Read and write security events

Development

Commands

Build: bun run build
Generate GraphQL types: bun run graphql-codegen

Project Structure

This project is a MCP Server for GitHub's GraphQL API, with focus on Project V2 operations. The codebase provides typed access to GitHub projects functionality through GraphQL.

Available Operations

Projects

Create, read, update, and delete GitHub Projects
Manage project fields, items, and status updates
Convert draft issues to actual issues
Archive and unarchive project items

Issues

Get issue details
Add issues to projects

Repositories

Get repository information

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Enables users to interact with GitHub's Projects v2 API through natural language for Agile project management, supporting repository details, issue tracking, and project board management operations.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-github-project-manager
kunwarVivek
-
security
A
license
-
quality
Provides comprehensive tools for managing GitHub projects, milestones, tasks, and sprints. This server integrates deeply with GitHub Projects V2, offering features like automated kanban workflows, sprint planning, and custom field management.
Last updated -
414
31
TypeScript
MIT License
GitHub MCP Server
asbloom-py
-
security
F
license
-
quality
Enables interaction with GitHub through the GitHub API, supporting file operations, repository management, advanced search, and issue tracking with comprehensive error handling and automatic branch creation.
Last updated -
9
1
TypeScript
PyGithub MCP Server
AstroMined
A
security
A
license
A
quality
Enables AI assistants to interact with GitHub through the PyGithub library, providing tools for managing issues, repositories, pull requests, and other GitHub operations with intelligent parameter handling and error management.
Last updated -
19
Python
MIT License
GitHub MCP Server
tuanle96
-
security
F
license
-
quality
Enables comprehensive GitHub operations through natural language including file management, repository administration, issue tracking, and advanced code searching.
Last updated -
22,573
1
TypeScript

View all related MCP servers

GitHub Projects MCP Server