GitHub Projects API (GraphQL)

GitHub Projects v2 is a flexible project management tool built on top of GitHub issues and pull requests. The GraphQL API enables agents to create and manage project boards, add items (issues/PRs/draft items), update custom fields, set status, and automate project workflows.

Evaluated Mar 06, 2026 (0d ago) vcurrent

Homepage ↗ Productivity github projects graphql issues kanban roadmap developer-tools agile

⚙ Agent Friendliness

/ 100

Can an agent use this?

🔒 Security

/ 100

Is it safe for agents?

⚡ Reliability

/ 100

Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality

Documentation

Error Messages

Auth Simplicity

Rate Limits

🔒 Security

TLS Enforcement

100

Auth Strength

Scope Granularity

Dep. Hygiene

Secret Handling

Fine-grained PAT with project-specific scopes. GitHub Projects v2 uses GraphQL API. SOC2, ISO27001, FedRAMP. Project data visibility controlled by repo/org permissions.

⚡ Reliability

Uptime/SLA

Version Stability

Breaking Changes

Error Recovery

Best When

An agent is already working within the GitHub ecosystem and needs to manage work items alongside code.

Avoid When

Your team uses Jira, Linear, or another issue tracker as the source of truth — syncing between systems adds fragility.

Use Cases

• Automatically triaging and adding issues to project boards
• Updating project item status based on CI/CD pipeline outcomes
• Creating draft items for agent-identified work or technical debt
• Reporting on project status and velocity across sprints
• Syncing project state with external planning tools

Not For

• Non-GitHub workflows — Projects v2 is tightly coupled to GitHub issues and PRs
• Complex Gantt or dependency management
• Teams not already using GitHub for code hosting

Interface

REST API

GraphQL

Yes

gRPC

MCP Server

SDK

Yes

Webhooks

Yes

Authentication

Methods: oauth2 personal_access_token github_app

OAuth: Yes Scopes: Yes

GitHub Apps are strongly recommended for agents — fine-grained permissions per repo/org, no user token expiry, and installation-level tokens. PATs (classic and fine-grained) also work. OAuth apps for multi-user scenarios. Projects v2 requires 'project' scope on classic PATs or specific GraphQL mutations granted to GitHub Apps.

Pricing

Model: included

Free tier: Yes

Requires CC: No

Projects v2 is included with all GitHub plans at no additional cost. API access is part of GitHub's standard API offering.

Agent Metadata

Pagination

cursor

Idempotent

Partial

Retry Guidance

Documented

Known Gotchas

⚠ Projects v2 is GraphQL-only — no REST fallback; agents must handle GraphQL query construction
⚠ Rate limiting uses a point system, not a simple request count — complex queries cost more points
⚠ Node IDs for projects use base64-encoded global IDs; store them, do not construct them
⚠ Custom fields must be queried by field ID, not field name — fetch field metadata first
⚠ Draft items do not have associated GitHub issues; mutations differ from issue-backed items
⚠ Organization-level projects require org admin token or GitHub App with org-level installation
⚠ Project item ordering is manual/human-driven — no API for setting sort position

Alternatives

linear-api jira-api asana-api gitlab-api

Full Evaluation Report

Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for GitHub Projects API (GraphQL).

$99

API endpoint ↗ Agent guide ↗ Report inaccuracy

Scores are editorial opinions as of 2026-03-06.