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.
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 using uvx
as the command runner:
{
"mcpServers": {
"github-projects": {
"command": "uvx",
"args": [
"mcp-github-projects"
],
"env": {
"GITHUB_TOKEN": "your_pat_here"
}
}
}
}
Make sure to replace your_pat_here
with your actual GitHub Personal Access
Token.
To run the project directly from source code, follow these steps:
Clone the repository:
git clone git@github.com:Arclio/github-projects-mcp.git
cd github-projects-mcp
Create and activate a virtual environment:
uv venv
source venv/bin/activate
Install dependencies:
uv pip install -e .
Set your GitHub token as an environment variable:
Create a GitHub Personal Access Token and give it the necessary permissions.
The required permissions are: repo
, project
, and read:org
.
Add the token to your .env
file after running this command:
cp .env.example .env
Then add the following to your .env
file:
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-mcp
and your_pat_here
with
your actual repository path and GitHub Personal Access Token.
list_projects
: List GitHub Projects V2 for a given organization or userget_project_fields
: Get fields available in a GitHub Project V2get_project_items
: Get items in a GitHub Project V2 (supports filtering by
state or custom single-select fields)create_issue
: Create a new GitHub issueadd_issue_to_project
: Add an existing GitHub issue to a Project V2update_project_item_field
: Update a field value for a project itemcreate_draft_issue
: Create a draft issue directly in a GitHub Project V2delete_project_item
: Delete an item from a GitHub Project V2See tool documentation in the server code for detailed usage information.
The project is structured as follows:
src/github_projects_mcp/
: Main package directory
server.py
: MCP server implementation with tool definitionsgithub_client.py
: GraphQL client for GitHub API interactionsTo contribute, make sure to:
Connects AI assistants to Obsidian vaults stored in GitHub repositories, enabling them to read, search, and analyze your notes and documentation.
Token-based GitHub automation management. No Docker, Flexible configuration, 80+ tools with direct API integration.
Interact with GitHub APIs for automation and repository management.
GitHub's official MCP Server
Interact with GitHub repositories, including issues, pull requests, commits, releases, and actions.
Manage GitHub repositories using a personal access token via CLI or environment variables.
An MCP server for integrating with and managing Subversion (SVN) repositories, enabling AI agents to perform version control tasks.
Integrates with GitHub, allowing LLMs to interact with repositories, issues, and pull requests via the GitHub API.
A CLI for interacting with GitKraken APIs. Includes an MCP server via `gk mcp` that not only wraps GitKraken APIs, but also Jira, GitHub, GitLab, and more.
An MCP server for interacting with and automating Git repositories using Large Language Models.