GitHub Projects V2

Manage GitHub Projects V2 using the GitHub GraphQL API.

A Model Context Protocol (MCP) server that provides tools for managing GitHub Projects V2 through Claude and other MCP clients. This server uses the GitHub GraphQL API for interacting with GitHub Projects V2.

- List and view GitHub Projects V2 for users and organizations
- Get project fields and items (issues, PRs, draft issues)
- Create issues and add them to projects
- Create draft issues directly in projects
- Update project item field values
- Delete items from projects

This server can be used with any MCP client, such as Claude Desktop. Add it to your MCP client configuration (e.g.,claude_desktop_config.json).

Here's an example configuration usinguvxas the command runner:

{ "mcpServers": { "github-projects": { "command": "uvx", "args": [ "mcp-github-projects" ], "env": { "GITHUB_TOKEN": "your_pat_here" } } } }

Make sure to replaceyour_pat_herewith your actual GitHub Personal Access Token.

To run the project directly from source code, follow these steps:

git clone git@github.com:Arclio/github-projects-mcp.git cd github-projects-mcp

Create and activate a virtual environment:

Set your GitHub token as an environment variable:

Create a GitHub Personal Access Tokenand give it the necessary permissions. The required permissions are:repo,project, andread:org.

export GITHUB_TOKEN=your_personal_access_token

{ "mcpServers": { "github-projects": { "command": "uv", "args": [ "--directory", "/path/to/github-projects-mcp", "run", "mcp-github-projects" ], "env": { "GITHUB_TOKEN": "your_pat_here" } } } }

Make sure to replace/path/to/github-projects-mcpandyour_pat_herewith your actual repository path and GitHub Personal Access Token.

- list_projects: List GitHub Projects V2 for a given organization or user
- get_project_fields: Get fields available in a GitHub Project V2
- get_project_items: Get items in a GitHub Project V2 (supports filtering by state or custom single-select fields)
- create_issue: Create a new GitHub issue
- add_issue_to_project: Add an existing GitHub issue to a Project V2
- update_project_item_field: Update a field value for a project item
- create_draft_issue: Create a draft issue directly in a GitHub Project V2
- delete_project_item: Delete an item from a GitHub Project V2

See tool documentation in the server code for detailed usage information.

- src/github_projects_mcp/: Main package directory

- server.py: MCP server implementation with tool definitions
- github_client.py: GraphQL client for GitHub API interactions
- Add proper error handling for all GraphQL operations
- Add type annotations for all functions and parameters
- Update documentation when adding new tools or features

Official GitHub MCP server for repository search, issues, pull requests, code context, and GitHub workflows in MCP-compatible AI clients.

Interact with GitHub repositories, including issues, pull requests, commits, releases, and actions.

Integrate with the GitHub Enterprise API to access repositories, issues, pull requests, and workflows.

Manage GitHub issues as a Kanban board using the gh CLI.

Provides tools for mapping and analyzing GitHub repositories using a Personal Access Token for authentication.

Integrates with GitHub, allowing LLMs to interact with repositories, issues, and pull requests via the GitHub API.

Interact with GitHub repositories, issues, pull requests, and more. Requires a GitHub personal access token.

Interact with the GitHub API to create and manage repositories, including setting descriptions, topics, and website URLs.

An MCP server for interacting with GitHub, allowing you to manage repositories, issues, and pull requests.

GitHub Project Manager with Resource System

A server for GitHub project management with advanced resource management, capacity planning, and workload optimization capabilities.