GitHub
Let your app or AI agent work with code projects.
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/pricing2. Commercial use
“You may not share API tokens to exceed GitHub's rate limitations.”
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.
docs.github.com/en/site-policy/github-terms/github-terms-of-service3. Key & sign-up
“After creating a token, you can authenticate your request by sending the token in the Authorization header of your request.”
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.
docs.github.com/api/article/body?pathname=/en/rest/authentication/authenticating-to-the-rest-api4. Agent access
“The remote GitHub MCP Server is hosted by GitHub and provides the easiest method for getting up and running.”
Our agent check: 3 of 6 (Nov 13, 2026).
github.com/github/github-mcp-server/blob/main/README.mdChecked 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
SDK downloads from npm and PyPI, weekly. Numbers as of Nov 17, 2026.
Pricing
Unlimited public/private repositories, 2,000 CI/CD minutes/month, 500MB Packages storage
$4 a month
GitHub Codespaces: $0.18/hour compute, $0.07/GB storage/month
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
| Action | Price |
|---|---|
| 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
60 requests per hour per IP address, public data only
5,000 requests per hour per user
1,000 requests per hour per repository
At most 100 requests at the same time; about 80 content-creating requests a minute and 500 an hour
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
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.
No name is read automatically by Octokit; GitHub CLI reads GH_TOKEN, and Actions provides GITHUB_TOKENNo
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.
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
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
github.com is one global service; GitHub Enterprise Cloud with data residency runs on its own ghe.com address.
Errors to handle
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.
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.
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.
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.
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
3 of 6: llms.txt yes, OpenAPI no, SDK yes, MCP no, status page no, AI assistants allowed yes
Checked Nov 13, 2026.
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 install octokitAlternatives
GitHub This page
Pick Trigger.dev when you need long-running background tasks with no timeouts, not jobs tied to a code project.
Pick Inngest when your app needs event-driven background functions and agent workflows that retry on their own.
Pick Arcade when your AI agent must act in many outside services, GitHub among them, with sign-ins handled for each user.
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.”
Create a fine-grained personal access token with only the permissions and repositories you need, and an expiry date.
Install Octokit for JavaScript (or call the API with curl or any web request).
npm install octokitFrom docs.github.com/api/article/body?pathname=/en/rest/quickstart
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"]}'
Status: 201
{
"id": 1,
"url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
"html_url": "https://github.com/octocat/Hello-World/issues/1347",
"number": 1347,
"state": "open",
"title": "Found a bug",
"body": "I'm having a problem with this.",
"user": { "login": "octocat", "id": 1 }
}
Mistakes to avoid
Requests without it are rejected, and an invalid one gets 403.
A token can do everything its owner can within its scopes.
GitHub hides private resources behind 404, and a wrong method also gives 404.
Continuing while rate limited can get the integration banned.
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.