GitHub

You have a modern MCP server that integrates with GitHub to manage projects, track issues, milestones, and PRDs, and to provide AI-powered analytics and planning tools. It lets you run all core project-management actions from a unified interface, collaborate with teammates, and extract actionable insights to guide product development and delivery.

How to use

You will use an MCP client to interact with the GitHub Project Manager MCP server. The server exposes a comprehensive set of tools for issue and milestone management, label handling, analytics, and PRD planning. You can perform common workflows such as creating and updating issues, tracking milestones, generating PRDs, parsing PRDs into tasks, and creating roadmaps. Use the available tools to generate AI-assisted estimates, assess readiness, and visualize project health and progress.

How to install

Prerequisites: you need Node.js installed on your machine. Ensure you have a GitHub Personal Access Token with the required scopes for repository and organization access.

cd /path/to/github-project-manager-mcp
npm install
npm run build

Configuration and usage notes

This MCP server is designed to run as a local stdio server. The runtime command and environment you need to start the server are shown in the configuration snippet below. Use the provided environment variable placeholders to supply your own tokens and identifiers.

{
  "mcpServers": {
    "github_pm": {
      "command": "node",
      "args": ["C:\\tmp\\github-project-manager-mcp-local\\build\\index.js"],
      "env": {
        "GITHUB_TOKEN": "your-github-personal-access-token",
        "GITHUB_OWNER": "your-github-username", 
        "GITHUB_REPO": "your-repository-name"
      }
    }
  }
}

Usage patterns

Common workflows you can implement include creating issues with labels and assignees, listing and filtering issues, retrieving detailed issue information, and updating issues. You can also create and monitor milestones, compute progress metrics, identify overdue items, and surface upcoming milestones. Use the analytics tools to estimate task complexity, assess repository health, and generate or parse PRDs. Build roadmaps and enhance PRDs with market and technical insights.

Security and best practices

Protect your GitHub token and owner/repo identifiers. Use strong, scoped tokens and rotate credentials periodically. Limit tool access to only the teams and repositories that require it. Monitor usage and handle errors gracefully to avoid exposing sensitive data.

Available tools

create_issue

Create a new issue with labels, assignees, and milestone information.

list_issues

List or filter issues by state, labels, and assignee.

get_issue

Fetch detailed information for a specific issue.

update_issue

Update issue title, description, state, and assignments.

create_milestone

Create a milestone with due date and description.

list_milestones

List and sort milestones by criteria such as due date or completion.

get_milestone_metrics

Compute progress metrics for a milestone.

get_overdue_milestones

Identify milestones that are overdue and require attention.

get_upcoming_milestones

Show milestones due within a specified number of days.

analyze_task_complexity

AI-powered scoring of task complexity on a 1-8 scale.

get_repository_summary

Provide a comprehensive health analysis of the repository.

generate_prd

Generate a comprehensive Product Requirements Document.

parse_prd

Parse an existing PRD to extract actionable development tasks.

enhance_prd

Enhance PRD with market analysis and technical recommendations.

add_feature

Add a feature with impact analysis across business, technical, and user perspectives.

create_roadmap

Create a project roadmap with timelines and milestone mapping.

create_label

Create a color-coded label with a description for issues.

list_labels

List all repository labels.