Which integrations are available for this server?

Provides full CRUD operations for GitHub Projects V2, including managing projects, items, fields, and views through the GitHub API.

How do I use GitHub Projects MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@GitHub Projects MCP Server list my projects" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

GitHub Projects MCP Server

by Lexmata

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

GitHub Projects MCP Server

A Model Context Protocol (MCP) server for GitHub Projects V2. Enables AI assistants to manage GitHub Projects, items, fields, and views through a standardized interface.

Features

Full GitHub Projects V2 Support: Complete CRUD operations for projects, items, fields, and views
Dual Authentication: Support for both Personal Access Tokens (PAT) and GitHub App authentication
User & Organization Projects: Manage projects for both individual users and organizations
17 Specialized Tools: Comprehensive toolset for all project management operations
Type-Safe: Built with TypeScript for complete type safety
Well Tested: 100% unit test coverage

Related MCP server: GitHub Projects MCP Server

Quick Start

Installation

npm install @lexmata/github-projects-mcp

Configuration

Set your GitHub token as an environment variable:

export GITHUB_TOKEN=ghp_your_personal_access_token

Or configure GitHub App authentication:

export GITHUB_APP_ID=123456
export GITHUB_APP_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----..."
export GITHUB_APP_INSTALLATION_ID=12345678

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "github-projects": {
      "command": "npx",
      "args": ["@lexmata/github-projects-mcp"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Running Directly

npx @lexmata/github-projects-mcp

Available Tools

Project Management

Tool	Description
`list_projects`	List projects for a user or organization
`get_project`	Get detailed project information
`create_project`	Create a new project
`update_project`	Update project settings
`delete_project`	Delete a project

Item Management

Tool	Description
`list_project_items`	List all items in a project
`get_project_item`	Get item details
`add_draft_issue`	Add a draft issue to project
`add_existing_issue`	Add existing issue/PR to project
`update_item_field`	Update a field value on an item
`remove_project_item`	Remove an item from project

Field Management

Tool	Description
`list_project_fields`	List all fields in a project
`create_field`	Create a custom field
`update_field`	Update field settings
`delete_field`	Delete a custom field

View Management

Tool	Description
`list_project_views`	List all views in a project
`get_project_view`	Get view details

Documentation

Getting Started - Quick start guide
Authentication - Configure GitHub authentication
Tools Reference - Complete tool documentation
Configuration - All configuration options
Examples - Usage examples

Required GitHub Permissions

For Personal Access Tokens (Classic)

repo - Full control of private repositories
project - Full control of projects

For Fine-grained Personal Access Tokens

Repository permissions:
- Issues: Read and write
- Pull requests: Read and write
Organization permissions:
- Projects: Read and write

For GitHub Apps

Repository permissions:
- Issues: Read and write
- Pull requests: Read and write
Organization permissions:
- Projects: Read and write

Development

Prerequisites

Node.js 18+
pnpm 9+

Setup

# Clone the repository
git clone https://github.com/Lexmata/github-projects-mcp.git
cd github-projects-mcp

# Install dependencies
pnpm install

# Run tests
pnpm test

# Run tests with coverage
pnpm test:coverage

# Build
pnpm build

# Run in development mode
pnpm dev

Project Structure

src/
├── index.ts          # Entry point
├── server.ts         # MCP server setup
├── config.ts         # Configuration handling
├── auth/             # Authentication providers
├── graphql/          # GraphQL client and queries
├── tools/            # Tool implementations
└── types/            # TypeScript types

Contributing

Contributions are welcome! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Model Context Protocol - The protocol specification
MCP SDK - Official MCP SDK
GitHub Projects API - GitHub GraphQL API documentation

Available Tools

17 tools

add_draft_issueB

Add a new draft issue to a GitHub Project V2

Inputs: projectId (required), title (required), body, assigneeIds.

add_existing_issueB

Add an existing issue or pull request to a GitHub Project V2

Inputs: projectId (required), contentId (required).

create_fieldB

Create a new custom field in a GitHub Project V2

Inputs: projectId (required), name (required), dataType (required), singleSelectOptions.

create_projectC

Create a new GitHub Project V2

Inputs: owner (required), ownerType (required), title (required).

delete_fieldB

Delete a custom field from a GitHub Project V2

Inputs: fieldId (required).

delete_projectB

Delete a GitHub Project V2

Inputs: projectId (required).

get_projectB

Get detailed information about a specific GitHub Project V2

Inputs: owner (required), ownerType (required), projectNumber (required).

get_project_itemB

Get detailed information about a specific item in a GitHub Project V2

Inputs: projectId (required), itemId (required).

get_project_viewB

Get detailed information about a specific view in a GitHub Project V2

Inputs: projectId (required), viewNumber (required).

list_project_fieldsB

List all fields in a GitHub Project V2

Inputs: projectId (required), first, after.

list_project_itemsB

List all items (issues, pull requests, draft issues) in a GitHub Project V2

Inputs: projectId (required), first, after.

list_projectsA

List GitHub Projects V2 for a user or organization

Inputs: owner (required), ownerType (required), first, after.

list_project_viewsB

List all views in a GitHub Project V2

Inputs: projectId (required), first, after.

remove_project_itemB

Remove an item from a GitHub Project V2

Inputs: projectId (required), itemId (required).

update_fieldC

Update a field in a GitHub Project V2

Inputs: fieldId (required), name (required).

update_item_fieldB

Update a field value on an item in a GitHub Project V2

Inputs: projectId (required), itemId (required), fieldId (required), value (required).

update_projectB

Update a GitHub Project V2 (title, description, readme, visibility, or closed status)

Inputs: projectId (required), title, shortDescription, readme, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A3.6/5.0

Scored 2026-06-07 23:50 across 17 tools

Disambiguation5/5

Each tool targets a distinct resource or action within GitHub Projects V2, with clear boundaries. For example, adding draft issues and adding existing issues are clearly differentiated by description, and all other tools have unique purposes.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern in snake_case, such as create_project, list_project_items, and update_item_field. The use of 'add' for issues vs 'create' for fields and projects is a minor convention shift but still logically consistent.

Tool Count5/5

17 tools is appropriate for a comprehensive GitHub Projects V2 management server. The tool count covers all major CRUD operations for projects, fields, items, and views without being excessive.

Completeness4/5

The tool set covers most important workflows: creating, reading, updating, and deleting projects, fields, and items. However, it lacks tools for creating, updating, or deleting views, and there is no dedicated tool to get a specific field by ID (only list). These are minor gaps but do not severely hinder core functionality.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

GitHub
io.github.github
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Version Control Developer Tools CI/CD & DevOps
1234,466
https://api.githubcopilot.com/mcp/
Robinson MCP for GitHub
com.robinsonaisystems
Operate GitHub from your AI assistant: repos, PRs, issues, Actions. Previews and read-only mode.
Version Control Developer Tools CI/CD & DevOps
1
https://github.robinsonaisystems.com/api/mcp
Tack
io.github.Thefirstmannnn
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Project Management Workplace & Productivity
1
https://YOUR_DOMAIN/mcp
OrbitB
io.github.Noveum
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Project Management Workplace & Productivity
94130
https://orbit.noveum.ai/mcp

Related MCP Servers

GitHub Projects MCP Server
Version Control Project Management Developer Tools
taylor-lindores-reeves
A
license
Not graded
quality
D
maintenance
Enables users to interact with GitHub's Projects v2 API through natural language for Agile project management, supporting repository details, issue tracking, and project board management operations.
Updated a year ago (2025-09-17 19:55 UTC)
35
GPL 2.0
GitHub Projects MCP Server
Project Management Version Control
TerraCo89
A
license
Not graded
quality
D
maintenance
Enables managing GitHub Project views, priorities, dependencies, and metrics through natural language.
Updated 4 months ago (2026-07-22 00:09 UTC)
1
MIT
GitHub MCP Server
Version Control Developer Tools
nitesh-kumar-pandey
F
license
Not graded
quality
D
maintenance
Enables AI assistants to perform GitHub operations such as creating repositories, issues, pull requests, and more through natural language.
Updated 4 months ago (2026-07-06 11:26 UTC)
-
github-project-management
Project Management Developer Tools
jersonmartinez
A
license
Not graded
quality
A
maintenance
Enables AI assistants to programmatically manage GitHub Project V2 boards with 100+ tools for issues, fields, workflows, and automation via MCP.
Updated 3 days ago (2026-11-11 17:24 UTC)
1
MIT

GitHub Projects MCP Server

Features

Quick Start

Installation

Configuration

Usage with Claude Desktop

Running Directly

Available Tools

Project Management

Item Management

Field Management

View Management

Documentation

Required GitHub Permissions

For Personal Access Tokens (Classic)

For Fine-grained Personal Access Tokens

For GitHub Apps

Development

Prerequisites

Setup

Project Structure

Contributing

License

Related

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

GitHub Projects MCP Server

GitHub Projects MCP Server

GitHub MCP Server

github-project-management