Skip to content
Agents tracked: 502 Releases (7d): 613 Agent status: 4 with issuesSince last limit reset: Claude 7d · Codex 5d For AI agents: Markdown Updated Nov 18, 2026

GitHub

Let your app or AI agent work with code projects.

Integrations and automation

WebsitePricingGitHub

1. Price

“2,000 ci/cd minutes/month 500mb of packages storage”

Free tier: Unlimited public/private repositories, 2,000 CI/CD minutes/month, 500MB Packages storage. As reported on the official pricing page, checked Oct 26, 2026.

github.com/pricing

Checked against the maker's official pages, pricing on Oct 26, 2026. Tap a verdict to see its source.How we checkedReport an error

What GitHub does

The GitHub API lets your app, script or AI assistant do in code what you do on github.com, such as reading a project, opening an issue or publishing a release. Public data can be read without an account, at a low hourly limit. With a personal token it can act on your own projects.

  • GitHub is one of 17 APIs in the Integrations and automation category on AgentGid.
  • Its cheapest paid plan ($4 a month) is the 2nd cheapest of the 15 here with a monthly plan.
  • It is one of 16 that can be started for free.
  • 6 of them ship an official MCP server; GitHub does not.
  • Its official SDK is the 1st most downloaded in the category (14.8M a week).

What people build with it

Project stats on your website Idea

Show the star count, license and latest release of your open-source project on your landing page, read live from GitHub.

Feedback form that opens issues

Turn a bug report from your app's feedback form into an issue in your project, so nothing gets lost in email.

Jobs that run inside your project

Run a scheduled or one-click job in GitHub Actions that reads or updates issues, with a built-in token and no key to manage.

Your AI assistant works on GitHub

Let an AI assistant read code, triage issues and review pull requests in your projects through GitHub's own MCP server.

Deploy or notify when code changes

Get a message on your server when someone pushes code or opens a pull request, then deploy the site or post to your team chat.

Content stored in a project Idea

Keep blog posts or app settings as files in a GitHub project and have your site read and update them.

GitHub popularity

4M
SDK downloads a week
-24.7% on the 4-week average
54
public agent repos use its SDK
7,880
GitHub stars, octokit/octokit.js
SDK downloads per weeknpm octokit 4,016,073

SDK downloads from npm and PyPI, weekly. Numbers as of Nov 17, 2026.

Pricing

Free tier

Unlimited public/private repositories, 2,000 CI/CD minutes/month, 500MB Packages storage

Cheapest plan

$4 a month

Usage price

GitHub Codespaces: $0.18/hour compute, $0.07/GB storage/month

Plans

Added automatically: its SDK was in 161 of the public agent repos we sampled when it was added; integrations in CrewAI, LlamaIndex. Prices read from the official pricing page.

What one action costs

ActionPrice
Free plan for a month (API access within rate limits, 2,000 CI/CD minutes)$0
Team plan, one user for a month$4
Price history
  • A year of the pricing page in the Internet Archive (13 months): the lowest monthly figure went from $5 (2025-10) to $5 (2026-10).

As reported on the official pricing page, checked Oct 26, 2026. Prices change: confirm before you buy. github.com/pricing

Limits

No token

60 requests per hour per IP address, public data only

Personal access token

5,000 requests per hour per user

GITHUB_TOKEN in Actions

1,000 requests per hour per repository

All

At most 100 requests at the same time; about 80 content-creating requests a minute and 500 an hour

All

Requests taking over 10 seconds are cut off

From the official docs. docs.github.com/api/article/body?pathname=/en/rest/using-the-rest-api/rate-limits-for-the-rest-api

Key and access

How it signs in

A token in the Authorization header (Authorization: Bearer <token>): a fine-grained personal access token, a GitHub App token, or the built-in GITHUB_TOKEN in GitHub Actions. Public data can be read without a token.

Environment variable
No name is read automatically by Octokit; GitHub CLI reads GH_TOKEN, and Actions provides GITHUB_TOKEN
Safe in browser code
No, keep it on your server
Card at sign-up

No

Steps only a person can do

  • Sign in to GitHub and create a fine-grained personal access token for the repositories the app needs. Put it in .env as GITHUB_TOKEN (kept out of git) and pass it to new Octokit({ auth }) on the server.
  • To act for other users or an organization, register a GitHub App and install it on the organization. Store the app's client ID and private key as secrets and create installation tokens in code.
  • For jobs inside GitHub Actions, set the workflow's permissions block; no token needs creating. Use secrets.GITHUB_TOKEN as GH_TOKEN in the workflow step.

Commercial use and your data

Calling the GitHub API costs nothing within the rate limits. You may build paid products on it, but not spam people, sell users' personal data, or share tokens to get past the limits.

In a paid app
With conditions

Allowed under GitHub's terms; no spam, no selling users' personal data, no sharing tokens to exceed limits, and high-throughput or resale use needs a separate subscription.

“You may not share API tokens to exceed GitHub's rate limitations.” source

inside-app-bundle
Yes

The octokit package is MIT licensed and can ship inside your app.

“"license":"MIT"” source

To train your own AI
With conditions

The terms do not ban collecting public data through the API, but it may not be used for spam or to sell personal information, and the privacy statement applies.

“Your use of information from the Service must comply with the GitHub Privacy Statement” source

Where data is stored

github.com is one global service; GitHub Enterprise Cloud with data residency runs on its own ghe.com address.

Errors to handle

401

The token is invalid; after several bad attempts GitHub briefly refuses all logins for that user with 403.

Check the token, its expiry and the Authorization header; stop retrying with a bad token.

403 or 429 (rate limit)

The hourly limit or a secondary limit was hit; x-ratelimit-remaining is 0 or the message names a secondary limit.

Wait for retry-after or x-ratelimit-reset, otherwise at least a minute, then back off exponentially.

404

Often not missing at all; a private resource without proper access returns 404 instead of 403.

Check the token's permissions, owner and repository access, the URL (no trailing slash) and the HTTP method.

403 (resource not accessible)

The fine-grained token or GitHub App lacks a permission the endpoint needs.

Read the X-Accepted-GitHub-Permissions header and add exactly that permission to the token or app.

422

The request body failed validation, or the endpoint has been spammed.

Fix the fields named in the error; slow down content-creating requests.

Use it from an agent

Our agent check

3 of 6: llms.txt yes, OpenAPI no, SDK yes, MCP no, status page no, AI assistants allowed yes

Checked Nov 13, 2026.

MCP server

GitHub MCP Server (remote, hosted by GitHub; also runs locally in Docker)

claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'

npm
npm install octokit

Alternatives

GitHub This page

from $0.07/GB storageFree tier

Trigger.dev

Pick Trigger.dev when you need long-running background tasks with no timeouts, not jobs tied to a code project.

$0.025 / 1k requestsFree tier

Inngest

Pick Inngest when your app needs event-driven background functions and agent workflows that retry on their own.

$0.05 / 1k requestsFree tier

Arcade

Pick Arcade when your AI agent must act in many outside services, GitHub among them, with sign-ins handled for each user.

$10 / 1k requestsFree tierOfficial MCP

All integrations and automation APIs

Get started

Tell your AI assistant

“Use the GitHub API with octokit 5.0.5 on the server: read a fine-grained token from GITHUB_TOKEN in .env, send a clear User-Agent, handle 403/429 by waiting for x-ratelimit-reset, and paginate list results.”

  1. Create a fine-grained personal access token with only the permissions and repositories you need, and an expiry date.

    From docs.github.com/api/article/body?pathname=/en/rest/authentication/keeping-your-api-credentials-secure

  2. Install Octokit for JavaScript (or call the API with curl or any web request).

    npm install octokit

    From docs.github.com/api/article/body?pathname=/en/rest/quickstart

  3. Create a client with your token and send a request.

    const octokit = new Octokit({
      auth: 'YOUR-TOKEN'
    });
    await octokit.request("GET /repos/{owner}/{repo}/issues", {
      owner: "octocat",
      repo: "Spoon-Knife",
    });
    

    From docs.github.com/api/article/body?pathname=/en/rest/quickstart

First request

curl -L \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/repos/OWNER/REPO/issues \
  -d '{"title":"Found a bug","body":"I'\''m having a problem with this.","assignees":["octocat"],"milestone":1,"labels":["bug"]}'

Mistakes to avoid

Calling the API from a script with no User-Agent header.
Send User-Agent with your app name or GitHub username (curl and Octokit send one by default).

Requests without it are rejected, and an invalid one gets 403.

A classic personal access token with the full repo scope and no expiry.
A fine-grained token limited to the needed repositories and permissions, with an expiry date.

A token can do everything its owner can within its scopes.

Treating 404 as "this project does not exist".
First check the token's permissions and repository access, the URL and the HTTP method.

GitHub hides private resources behind 404, and a wrong method also gives 404.

Firing many requests in parallel or retrying at once after a 403 or 429.
Send requests one after another, wait a second between writes, and honour retry-after and x-ratelimit-reset.

Continuing while rate limited can get the integration banned.

Reading only the first answer of a list endpoint.
Follow pagination (Octokit's paginate helper or the Link header) until there are no more pages.

Most lists return 30 items by default.

Questions

Do I need an account to use the GitHub API?

Not for public data; you can read it without a token, up to 60 requests an hour. Writing or reading private data needs a token.

Which token should I use?

For yourself, a fine-grained personal access token; for acting on behalf of an organization or other users, a GitHub App; inside Actions, GITHUB_TOKEN.

Why do I get 404 for a project that exists?

GitHub answers 404 for private resources you are not allowed to see; check the token's access.

How do I avoid checking for changes over and over?

Subscribe to webhooks, which send events to your server as they happen.

Is there an MCP server for my AI assistant?

Yes, GitHub's own MCP server, hosted by GitHub or run locally; it signs in with OAuth or a personal access token.