# GitHub — card for AI agents

Platform for version control, collaboration, and automation of software development workflows.

Maker: GitHub · category: Integrations and automation

## Price (official page)
- Free tier: Unlimited public/private repositories, 2,000 CI/CD minutes/month, 500MB Packages storage
- Free tier terms: free allowance · monthly (read from the wording above and the pricing page; empty = not stated)
- Paid from $4/month
- Usage price: GitHub Codespaces: $0.18/hour compute, $0.07/GB storage/month
- Pricing page: https://github.com/pricing (checked 2026-10-09)
- Note: 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.

## Connect
- npm: `npm install octokit`
- Repository: https://github.com/octokit/octokit.js

## For AI agents on GitHub's own site (AgentGid check 2026-11-13: 3 of 6)
- llms.txt: https://github.com/llms.txt (full text: https://github.com/llms-full.txt)
- Docs pages as Markdown: 0% of the pages llms.txt lists
- OpenAPI description: none found at the usual places
- Official MCP server: no · official SDK: yes · status page: no
- robots.txt lets AI assistants (ChatGPT-User, Claude-User) read the site: yes

## A year of price history (Internet Archive copies of the pricing page, read by rules)
- Months read: 13 (2025-10 to 2026-10) of https://github.com/pricing
- Lowest $/month figure on the page: $5 in 2025-10, $5 in 2026-10
- A figure is any "$X/month" on the page (plans, seats and add-ons alike); open the archived copy to see which plan it is.

## Price history in AgentGid's catalog (since 2026-10-26)
- Changes recorded: 0 (a vendor price change or an editor's correction; the evidence archive keeps the pricing page of each date)

## Other APIs in this category
- Trigger.dev: https://agentgid.com/apis/trigger-dev/agent.md
- Temporal Cloud: https://agentgid.com/apis/temporal/agent.md
- Inngest: https://agentgid.com/apis/inngest/agent.md
- Arcade: https://agentgid.com/apis/arcade/agent.md
- Prefect Cloud: https://agentgid.com/apis/prefect/agent.md

## Links
- AgentGid page: https://agentgid.com/apis/github/


## GitHub API: let your app or AI agent work with code projects

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.

### Where to use it
- Project stats on your website: Show the star count, license and latest release of your open-source project on your landing page, read live from GitHub. (idea, not from the official pages)
- 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: Keep blog posts or app settings as files in a GitHub project and have your site read and update them. (idea, not from the official pages)

### How to start
- 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 octokit
```

- 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",
});
```


### License
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.

### Good to know
- Without a token you get 60 requests an hour from your internet address; a personal token raises this to 5,000.
- Every request needs a User-Agent header naming your app; requests without one are rejected.
- Lists return only 30 items by default; ask for the next pages to see the rest.
- Too many requests can get your access suspended, so use change notifications instead of asking again and again.
- A token acts as you, so keep it out of code and out of every project, even private ones.

Checked 2026-11-10 against: https://docs.github.com/llms.txt, https://docs.github.com/en/rest/quickstart, https://docs.github.com/api/article/body?pathname=/en/rest/quickstart, https://docs.github.com/en/rest/about-the-rest-api/about-the-rest-api, https://docs.github.com/api/article/body?pathname=/en/rest/about-the-rest-api/about-the-rest-api, https://docs.github.com/api/article/body?pathname=/en/rest/using-the-rest-api/getting-started-with-the-rest-api, https://docs.github.com/en/rest/using-the-rest-api/rate-limits-for-the-rest-api, https://docs.github.com/api/article/body?pathname=/en/rest/using-the-rest-api/rate-limits-for-the-rest-api, https://docs.github.com/api/article/body?pathname=/en/rest/using-the-rest-api/troubleshooting-the-rest-api, https://docs.github.com/api/article/body?pathname=/en/rest/using-the-rest-api/best-practices-for-using-the-rest-api, https://docs.github.com/api/article/body?pathname=/en/rest/using-the-rest-api/libraries-for-the-rest-api, https://docs.github.com/api/article/body?pathname=/en/rest/authentication/authenticating-to-the-rest-api, https://docs.github.com/api/article/body?pathname=/en/rest/authentication/keeping-your-api-credentials-secure, https://docs.github.com/en/rest/issues/issues, https://docs.github.com/api/article/body?pathname=/en/rest/issues/issues, https://docs.github.com/api/article/body?pathname=/en/rest/releases/releases, https://docs.github.com/api/article/body?pathname=/en/rest/repos/contents, https://docs.github.com/api/article/body?pathname=/en/webhooks/about-webhooks, https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens, https://docs.github.com/en/site-policy/github-terms/github-terms-of-service, https://docs.github.com/en/site-policy/acceptable-use-policies/github-acceptable-use-policies, https://github.com/pricing, https://github.com/github/github-mcp-server/blob/main/README.md, https://github.com/github/github-mcp-server/blob/main/docs/installation-guides/install-claude.md, https://github.com/octokit/octokit.js/blob/main/README.md, https://registry.npmjs.org/octokit/5.0.5, https://api.github.com/repos/octokit/octokit.js, https://api.github.com/repos/octokit/octokit.js/releases/latest

### Mistakes to avoid
- Don't: Calling the API from a script with no User-Agent header. → Do: 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.)
- Don't: A classic personal access token with the full repo scope and no expiry. → Do: 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.)
- Don't: Treating 404 as "this project does not exist". → Do: 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.)
- Don't: Firing many requests in parallel or retrying at once after a 403 or 429. → Do: 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.)
- Don't: Reading only the first answer of a list endpoint. → Do: 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.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
