GitHub Projects V2
About
Manage GitHub Projects V2 using the GitHub GraphQL API.
Explore
Setup
Install GitHub Projects V2 in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/arclio/github-projects-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
list_projects
List GitHub Projects V2 for a given organization or user. Args: owner: The GitHub organization or user name Returns: A formatted string with project details
get_project_fields
Get fields available in a GitHub Project V2, including options for SingleSelect fields. Args: owner: The GitHub organization or user name project_number: The project number Returns: A formatted string with field details.
get_project_items
Get items in a GitHub Project V2. Can filter by state OR a single custom field=value. Args: owner: The GitHub organization or user name project_number: The project number limit: Maximum number of items to return (default: 50). When filtering, the system automatically fetches more items to improve efficiency. state: Optional state filter (e.g., "OPEN", "CLOSED"). Applies to Issues/PRs. filter_field_name: Optional custom field name to filter by (e.g., "Status"). Currently supports SingleSelect and Iteration fields. filter_field_value: Optional custom field value to filter by (e.g., "In Development"). Uses case-insensitive matching. cursor: Optional cursor for pagination. Use value from previous results to get next page. Returns: A formatted string with item details.
create_issue
Create a new GitHub issue. Args: owner: The GitHub organization or user name repo: The repository name title: The issue title body: The issue body (optional) Returns: A formatted string with the created issue details
add_issue_to_project
Add an existing GitHub issue to a Project V2. Args: owner: The GitHub organization or user name that owns the project project_number: The project number issue_owner: The owner of the repository containing the issue issue_repo: The repository name containing the issue issue_number: The issue number Returns: A formatted string confirming the addition
update_project_item_field
Update a field value for a project item. Args: owner: The GitHub organization or user name project_number: The project number item_id: The ID of the item to update field_id: The ID of the field to update field_value: The new value for the field (text, date, or option ID for single select) Returns: A confirmation message
create_draft_issue
Create a draft issue directly in a GitHub Project V2. Args: owner: The GitHub organization or user name project_number: The project number title: The draft issue title body: The draft issue body (optional) Returns: A confirmation message with the new draft issue details
delete_project_item
Delete an item from a GitHub Project V2. Args: owner: The GitHub organization or user name project_number: The project number item_id: The ID of the item to delete Returns: A confirmation message
- list_projects: List GitHub Projects V2 for a given organization or user.
Args:
owner: The GitHub organization or user name
Returns:
A formatted string with project details
- get_project_fields: Get fields available in a GitHub Project V2, including options for SingleSelect fields.
Args:
owner: The GitHub organization or user name
project_number: The project number
Returns:
A formatted string with field details.
- get_project_items: Get items in a GitHub Project V2. Can filter by state OR a single custom field=value.
Args:
owner: The GitHub organization or user name
project_number: The project number
limit: Maximum number of items to return (default: 50). When filtering, the system automatically fetches more items to improve efficiency.
state: Optional state filter (e.g., "OPEN", "CLOSED"). Applies to Issues/PRs.
filter_field_name: Optional custom field name to filter by (e.g., "Status"). Currently supports SingleSelect and Iteration fields.
filter_field_value: Optional custom field value to filter by (e.g., "In Development"). Uses case-insensitive matching.
cursor: Optional cursor for pagination. Use value from previous results to get next page.
Returns:
A formatted string with item details.
- create_issue: Create a new GitHub issue.
Args:
owner: The GitHub organization or user name
repo: The repository name
title: The issue title
body: The issue body (optional)
Returns:
A formatted string with the created issue details
- add_issue_to_project: Add an existing GitHub issue to a Project V2.
Args:
owner: The GitHub organization or user name that owns the project
project_number: The project number
issue_owner: The owner of the repository containing the issue
issue_repo: The repository name containing the issue
issue_number: The issue number
Returns:
A formatted string confirming the addition
- update_project_item_field: Update a field value for a project item.
Args:
owner: The GitHub organization or user name
project_number: The project number
item_id: The ID of the item to update
field_id: The ID of the field to update
field_value: The new value for the field (text, date, or option ID for single select)
Returns:
A confirmation message
- create_draft_issue: Create a draft issue directly in a GitHub Project V2.
Args:
owner: The GitHub organization or user name
project_number: The project number
title: The draft issue title
body: The draft issue body (optional)
Returns:
A confirmation message with the new draft issue details
- delete_project_item: Delete an item from a GitHub Project V2.
Args:
owner: The GitHub organization or user name
project_number: The project number
item_id: The ID of the item to delete
Returns:
A confirmation message
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 [email protected]:Arclio/github-projects-mcp.git cd github-projects-mcp
Create and activate a virtual environment:
Set your GitHub token as an environment variable:
Add the token to your.envfile after running this command:
Then add the following to your.envfile:
export GITHUB_TOKEN=your_personal_access_token
When using from source code, configure your MCP client as follows:
{ "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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
