The GitHub Projects MCP Server allows you to programmatically manage GitHub Projects, Issues, and Repositories using the GitHub Projects v2 API. With this server, you can:
GitHub Projects Management: Create, read, update, delete, copy, and manage projects including updating status and marking as templates
Project Structure: Manage columns/status and fields, including creating, updating, and deleting fields and single-select options
Project Items: Add, update, position, archive, unarchive, and delete items (Issues/PRs/Drafts) within projects
GitHub Issues: Create, get, list, update issues and add them to projects
Draft Issues: Add draft issues to projects and convert them to regular issues
Repositories: Fetch repository details and list repositories for a user
Field Values: Update and clear field values for project items
The server is built with TypeScript for type safety and requires a GitHub Personal Access Token with appropriate permissions.
Provides integration with GitHub's Projects v2 API for Agile project management, allowing for managing GitHub Projects, Issues, and Repositories through a Model Context Protocol server.
Utilizes GraphQL for interacting with GitHub's Projects v2 API, supporting queries and mutations for projects, fields, items and other GitHub resources.
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
Related MCP server: GitHub MCP Server
Installation
Installing via Smithery
To install GitHub Projects MCP Server for Claude Desktop automatically via Smithery:
Usage
Manual Installation
Clone this repository:
git clone https://github.com/taylor-lindores-reeves/mcp-github-projects.git cd mcp-github-projectsInstall dependencies:
bun installCreate a
.envfile with your GitHub token:GITHUB_TOKEN=your_github_personal_access_token GITHUB_OWNER=your_github_usernameBuild the server:
bun run buildConfigure your MCP client with the following settings:
Environment Variables
GITHUB_TOKEN: GitHub Personal Access Token with appropriate permissionsGITHUB_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 projectsread:project- Read access of projectsrepo- Full control of private repositoriesrepo:status- Access commit statusrepo_deployment- Access deployment statuspublic_repo- Access public repositoriesrepo:invite- Access repository invitationssecurity_events- Read and write security events
Development
Commands
Build:
bun run buildGenerate 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