# GitHub Project Manager MCP server

> Lets an AI client manage GitHub Projects, issues, sprints, and releases, and coordinate a swarm of coding agents with task checkout and budgets.

- Repository: https://github.com/kunwarVivek/mcp-github-project-manager
- Page: https://hostedmcp.org/servers/kunwarvivek/mcp-github-project-manager
- Transport: stdio
- Stars: 105
- License: MIT

## Install

### Claude Code

```sh
claude mcp add mcp-github-project-manager -- npx -y mcp-github-project-manager
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp-github-project-manager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-github-project-manager"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp-github-project-manager": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-github-project-manager"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp-github-project-manager","type":"stdio","command":"npx","args":["-y","mcp-github-project-manager"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp-github-project-manager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-github-project-manager"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add mcp-github-project-manager -- npx -y mcp-github-project-manager
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp-github-project-manager]
command = "npx"
args = ["-y", "mcp-github-project-manager"]
```

### Gemini CLI

```sh
gemini mcp add -s user mcp-github-project-manager npx -- -y mcp-github-project-manager
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp-github-project-manager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-github-project-manager"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GITHUB_OWNER` | no | no |  |
| `GITHUB_REPO` | no | no |  |
| `GITHUB_TOKEN` | no | no |  |
| `MCP_TOOL_GROUPS` | no | no |  |

## Tools (21)

- `manage_project`
- `manage_issues`
- `manage_prs`
- `manage_milestones`
- `manage_sprints`
- `manage_labels`
- `manage_automation`
- `manage_iterations`
- `manage_status_updates`
- `manage_branches`
- `manage_releases`
- `manage_workflows`
- `manage_events`
- `ai_generate`
- `ai_analyze`
- `ai_plan`
- `agent_work`
- `agent_manage`
- `system`
- `analytics`
- `discover_tools`

## FAQ

### Which credentials can I use to authenticate the GitHub Project Manager MCP server?

It accepts a personal access token via GITHUB_TOKEN, an existing GitHub CLI login, or OAuth device flow sign-in. A PAT needs repo, project, and write:org scopes.

### What Node.js version does this MCP server require?

It requires Node.js 22.12.0 or newer, with Node 24 recommended.

### How do AI agents claim and complete tasks with this server?

Agents register with a role and capabilities, then use agent_work to checkout_task, get_task_context, and heartbeat. They submit work products through agent_manage and finish with complete_task.

### Can it turn a product idea into GitHub issues?

Yes, ai_generate runs idea to PRD to tasks and then materializes them into real GitHub issues, grouped into milestones and sprints.

### Do the AI features require an extra API key?

No, they are optional; without a provider key all the deterministic GitHub project, issue, and agent tools still work.
