GitHub Projects

GitHub Projects

— Manage GitHub Projects with full GraphQL API access including items, fields, and milestones.

2
Stars
1
Forks
3
Releases

Overview

The GitHub Projects MCP Server provides a Model Context Protocol interface to GitHub Projects, exposing core GitHub Projects functionality through standardized MCP tools for LLMs and other MCP clients. Built around a GraphQL-backed client, it supports retrieving projects at organization and user levels, managing project items (add, update, remove, archive), and handling project fields and field values, as well as creating, updating, and deleting projects. It offers multiple transport modes (stdio, Server-Sent Events, and HTTP streaming) for flexible deployment. The server emphasizes robustness with proper GitHub API error surfacing and configurable rate-limit retries, and enforces type safety via Pydantic models. Configuration is environment-driven, with options for API_MAX_RETRIES, API_RETRY_DELAY, MCP_TRANSPORT, MCP_HOST, MCP_PORT, and LOG_LEVEL. The project is described as a FastMCP server with tool definitions, and the README covers usage across Claude Code, Claude Desktop, and VS Code, along with development and troubleshooting guidance. It also notes security considerations around token scopes and local-only GitHub interactions.

Details

Owner
redducklabs
Language
Python
License
GNU General Public License v3.0
Updated
2025-12-07

Features

Complete GitHub Projects API Coverage

Supports retrieving projects, managing project items (add/update/remove/archive), handling fields and field values, and creating/updating/deleting projects.

Multiple Transport Modes

Supports stdio, Server-Sent Events (SSE), and HTTP streaming for flexible deployment.

Robust Error Handling

Surfaces GitHub API errors clearly and provides configurable rate limit retries.

Type Safety with Pydantic Models

Uses Pydantic models to ensure reliable data validation and clear errors.

Environment-based Configuration

Configurable entirely via environment variables (token, retries, transport, host/port, log level).

GraphQL-based GitHub API Access

GraphQL client wrapper with retry logic to interact with GitHub Projects data.

Audience

LLMsAccess GitHub Projects data via MCP tools within LLM workflows for planning and automation.
DevelopersIntegrate MCP tools into apps or services to manage projects and items.
MCP clientsProvide standardized access to GitHub Projects across MCP-enabled clients.

Tags

GitHubProjectsGraphQLMCPLLMPythonPydanticAutomation