github-projects
Provides tools for managing GitHub Projects v2 boards, including listing projects, fields, items, and views; creating and updating projects; adding issues/PRs and draft items; setting and clearing field values; archiving/deleting items; reconciling desired board state; and generating sprint and epic-breakdown views.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
github-projects
A plugin for Claude Code and Codex: Pydantic v2 models, PEP 544
protocols, and an MCP server for managing GitHub Projects v2 boards
(e.g. github.com/users/<owner>/projects/<n>) — with first-class support
for the draft HTTP QUERY method.
Architecture
server.py MCP server (mcp SDK v2, stdio) — 19 tools, structured output
│ depends on
protocols.py ProjectsBackend / GraphQLTransport (runtime-checkable Protocols)
│ implemented by
service.py GitHubProjectsService — GraphQL over the transport,
project-id + field caching, string→typed field-value coercion
graphql.py GraphQL documents (works for both user and org owners)
http.py QueryClient — HTTP QUERY (draft-ietf-httpbis-safe-method-w-body)
with per-origin capability memory and POST fallback
models.py Frozen Pydantic v2 models, __typename-discriminated unionsThe MCP layer depends only on the
ProjectsBackendprotocol, so backends are swappable and tests substitute fakes structurally.QueryClientsendsQUERYoptimistically, recordsAccept-Queryadvertisements, retries once on transport errors (QUERY is safe and idempotent), and permanently falls back toPOSTper origin on 405/501 — so it works against GitHub today and upgrades itself when GitHub ships QUERY support.
Related MCP server: GitHub Project MCP Server
Setup
The primary runtime is CPython 3.14.7 free-threaded (3.14.7t). It also
requires the gh CLI to be authenticated with the project scope:
gh auth refresh -s project # grants read + write for Projects v2Tokens are resolved from GITHUB_TOKEN / GH_TOKEN, else gh auth token.
uv sync
uv run pytest # 32 tests
uv run gh-projects-mcp # run the server on stdioUsing it from Claude Code and Codex
From the repository root:
# Claude Code (registered user-wide)
claude mcp add --scope user github-projects -- uv --directory "$PWD" run gh-projects-mcp
# Codex
codex mcp add github-projects -- uv --directory "$PWD" run gh-projects-mcpPlugin manifests live in .claude-plugin/plugin.json (with the MCP server
declared via ${CLAUDE_PLUGIN_ROOT}) and .codex-plugin/plugin.json; a
usage skill for both hosts is in skills/github-projects/SKILL.md.
Tools
Tool | Purpose |
| List boards for a user/org (optional search) |
| Board by owner + number |
| Fields incl. single-select options and iterations |
| Items with content + field values, optionally evaluated through a saved-view filter query |
| Create board; edit title/readme/visibility/closed |
| Add an issue/PR by URL |
| Add a draft issue |
| Set a field; values are strings coerced by field type — single-select and iteration match by name ( |
| Clear a field |
| Archive or remove an item |
| Idempotent desired-state reconciliation: fields and option aliases, semantically verified leaf/container views, ordered columns, explicit retirements, item metadata, epic/sub-issue hierarchy, native issue dependencies, and legacy dependency-prose cleanup |
| Status-column view of one iteration (or all items + unplanned bucket) |
| Per-epic completion rollup from the native sub-issue hierarchy |
| Saved views with name, layout, filter, and ordered visible fields |
| The project's long-horizon context trail |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Project board for ChatGPT, Claude and coding agents, with scoped MCP access to projects and tasks.
Operate GitHub from your AI assistant: repos, PRs, issues, Actions. Previews and read-only mode.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Simple kanban for small teams. Read and update your Moxboard boards and tasks from Claude.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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.35GPL 2.0
- AlicenseNot gradedqualityDmaintenanceEnables management of GitHub projects and issues using GitHub's GraphQL API. Supports creating/updating issues with images, managing labels and assignees, organizing ProjectsV2 boards, and updating project item statuses.2MIT
- AlicenseNot gradedqualityDmaintenanceEnables managing GitHub Project views, priorities, dependencies, and metrics through natural language.1MIT
- AlicenseBqualityDmaintenanceEnables GitHub project management from Claude, supporting issue creation, milestones, labels, changelog generation, and repository stats.85 npm1MIT