GitHub

GitHub is the platform where the world builds software. AllMCP provides 102 tools across 16 categories — repositories, branches, commits, file contents, issues, pull requests, code reviews, GitHub Actions, releases, labels, gists, notifications, organizations, search, and security alerts — behind a single endpoint.

All providers How connecting works

---

Connect

GitHub connects with a personal access token that you create in your own GitHub account. Fine-grained tokens are recommended: you choose exactly which repositories and permissions the connection can reach.

1. Create a personal access token

   In GitHub, open github.com/settings/personal-access-tokens (fine-grained, recommended) and click Generate new token. Grant it the repositories you want your agent to work with and the permissions the work needs — for the full tool surface: Contents, Issues, Pull requests, Actions, Administration (read), plus account-level Notifications and Gists if you want those categories. A classic token from github.com/settings/tokens with the repo, read:org, notifications, and gist scopes works too.

2. Open the secure key-entry page

   Ask your agent to connect GitHub. It replies with a browser link to the AllMCP key-entry page — the agent never sees or handles the token itself. Paste the token there. One field is required:

   • Personal access token — the value you copied above.

3. Start asking for work

   Once the token is saved, the GitHub tools are live on your existing AllMCP endpoint. Nothing else to install.

Caution

The connection can do exactly what the token allows — no more, no less. A fine-grained token scoped to two repositories keeps your agent inside those two repositories. Fine-grained tokens also expire (up to one year); when one expires, tools return a reconnect link automatically and you paste a fresh token.

Tip

To disconnect, revoke the token at the same GitHub settings page, or ask your agent to disconnect GitHub. Revoking on GitHub’s side takes effect immediately.

---

Tools by category

Once GitHub is connected, your agent can use the tools below. You never call them by name — describe the outcome you want in plain language and the agent picks the tools.

Eight categories are available the moment you connect — repositories, branches, commits, files, issues, pull requests, search and users — the everyday development loop. The remaining eight (reviews, Actions, releases, labels, gists, notifications, organizations, security) become available as soon as a request needs them.

Users

Tool	What it does
github_get_me	Get the authenticated user’s profile (whoami for the connected PAT).
github_get_user	Get a user’s (or organization account’s) public profile by login.

Repositories

Tool	What it does
github_list_repositories	List repositories — the authenticated user’s, a user’s, or an org’s.
github_get_repository	Get one repository’s details (default branch, visibility, counts…).
github_create_repository	Create a new repository for the user or an organization.
github_update_repository	Update repository settings (rename, description, visibility, flags).
github_delete_repository	PERMANENTLY delete a repository (requires an explicit confirmation).
github_fork_repository	Fork a repository (asynchronous on GitHub’s side — may take a minute).
github_list_collaborators	List a repository’s collaborators with their permission levels.
github_add_collaborator	Invite a user as a repository collaborator (or update their role).
github_remove_collaborator	Remove a collaborator from a repository.
github_list_stargazers	List the users who starred a repository.
github_list_starred_repositories	List repositories starred by the authenticated user (or any user).
github_star_repository	Star a repository as the authenticated user.
github_unstar_repository	Remove the authenticated user’s star from a repository.

Branches

Tool	What it does
github_list_branches	List a repository’s branches (name, head SHA, protected flag).
github_get_branch	Get one branch: head commit and protection status.
github_create_branch	Create a new branch from another branch (or an exact commit SHA).
github_delete_branch	Delete a branch (its unmerged commits become unreachable).
github_merge_branch	Merge one branch into another directly (no pull request).

Commits

Tool	What it does
github_list_commits	List commits on a branch/ref, optionally filtered by path/author/date.
github_get_commit	Get one commit with its stats and changed files.
github_compare_commits	Compare two refs: ahead/behind counts, commits, and changed files.

Files

Tool	What it does
github_get_file_contents	Read a file’s text content, or list a directory’s entries.
github_create_or_update_file	Create a new file or overwrite an existing one (one commit).
github_delete_file	Delete one file (one commit). The file stays in git history.
github_push_files	Commit many file writes/deletes atomically to a branch.
github_get_repository_tree	List a repository’s file tree (paths, types, sizes) in one call.

Issues

Tool	What it does
github_list_issues	List a repository’s issues with label/assignee/state filters.
github_get_issue	Get one issue with its full body (also surfaces the global numeric id).
github_create_issue	Create an issue.
github_update_issue	Update an issue (edit, label, assign, close/reopen).
github_list_issue_comments	List an issue’s (or a PR conversation’s) comments.
github_add_issue_comment	Comment on an issue (or a pull request’s conversation).
github_update_issue_comment	Edit an issue/PR-conversation comment.
github_delete_issue_comment	Delete an issue/PR-conversation comment.
github_list_sub_issues	List an issue’s sub-issues (children in the issue hierarchy).
github_add_sub_issue	Attach an existing issue as a sub-issue of a parent issue.
github_remove_sub_issue	Detach a sub-issue from its parent (neither issue is deleted).

Pull requests

Tool	What it does
github_list_pull_requests	List a repository’s pull requests.
github_get_pull_request	Get one PR: full body, mergeability, size, head/base SHAs.
github_create_pull_request	Open a pull request from head into base.
github_update_pull_request	Edit a PR’s title/body, close/reopen it, or retarget its base.
github_merge_pull_request	Merge a pull request — refused when not mergeable or when the head moved since review.
github_list_pull_request_files	List the files a PR changes (per-file diffs available in full mode).
github_list_pull_request_commits	List the commits that make up a pull request.
github_get_pull_request_diff	Get a PR’s complete unified diff as text (capped at 200k chars).
github_update_pull_request_branch	Update a PR’s branch with the latest base-branch commits (sync).
github_request_reviewers	Request reviews on a PR from users and/or teams.

Reviews

Tool	What it does
github_list_pull_request_reviews	List a PR’s reviews (who approved / requested changes, and when).
github_create_pull_request_review	Submit a PR review (approve / request changes / comment) in one call.
github_list_review_comments	List a PR’s inline review comments (file/line anchored).
github_add_review_comment	Add one inline review comment to a PR, or reply to an existing one.

Actions

Tool	What it does
github_list_workflows	List a repository’s workflows (id, name, file path, state).
github_trigger_workflow	Trigger a workflow_dispatch run.
github_list_workflow_runs	List workflow runs (CI history), newest first.
github_get_workflow_run	Get one workflow run (status, conclusion, timing, trigger).
github_cancel_workflow_run	Cancel an in-progress workflow run.
github_rerun_workflow_run	Re-run a completed workflow run (all jobs, or failed jobs only).
github_list_workflow_jobs	List a run’s jobs (per-job status; failed step names surfaced).
github_get_job_logs	Fetch a job’s plaintext log (tail — where the failure output lives).
github_list_run_artifacts	List the artifacts a workflow run produced (name, size, expiry).
github_list_check_runs	List the check runs on a commit/branch (the PR status checks).

Releases

Tool	What it does
github_list_releases	List a repository’s releases (drafts included when the token may).
github_get_release	Get one release — by id, by tag, or the latest published one.
github_create_release	Create (and by default publish) a release.
github_update_release	Edit a release (also how a draft gets published: draft=False).
github_delete_release	Delete a release (its git tag survives — delete that separately if needed via github_delete_branch’s ref sibling, /git/refs/tags).
github_list_tags	List a repository’s git tags (name + commit SHA).

Labels

Tool	What it does
github_list_labels	List a repository’s labels.
github_create_label	Create a label in a repository.
github_update_label	Rename or restyle a label (issues keep it through the rename).
github_delete_label	Delete a label (it’s removed from every issue/PR carrying it).
github_list_milestones	List a repository’s milestones with open/closed issue counts.
github_create_milestone	Create a milestone.
github_update_milestone	Edit, close, or reopen a milestone.
github_delete_milestone	Delete a milestone (issues keep existing, just lose the milestone).

Gists

Tool	What it does
github_list_gists	List the authenticated user’s gists.
github_get_gist	Get one gist with its files’ contents.
github_create_gist	Create a gist from one or more files.
github_update_gist	Update a gist’s description and/or files (add, rewrite, delete).
github_delete_gist	Delete a gist permanently.

Notifications

Tool	What it does
github_list_notifications	List the authenticated user’s notification threads.
github_get_notification_thread	Get one notification thread’s details.
github_mark_notifications_read	Mark one notification thread — or the whole inbox — as read.

Organizations

Tool	What it does
github_list_my_organizations	List the organizations the authenticated user belongs to.
github_get_organization	Get an organization’s profile (repo/member counts; visible fields depend on the token’s role in the org).
github_list_organization_members	List an organization’s members.
github_list_teams	List an organization’s teams (slug is the id other tools take).
github_list_team_members	List a team’s members.

Search

Tool	What it does
github_search_repositories	Search repositories across GitHub.
github_search_code	Search code (file matches; tightest rate limit — 10 req/min).
github_search_issues	Search issues across GitHub (PRs excluded — see search_pull_requests).
github_search_pull_requests	Search pull requests across GitHub.
github_search_users	Search users and organizations across GitHub.
github_search_commits	Search commit messages across GitHub.

Security

Tool	What it does
github_list_code_scanning_alerts	List a repository’s code scanning alerts (CodeQL et al.).
github_get_code_scanning_alert	Get one code scanning alert (rule, location, remediation state).
github_list_secret_scanning_alerts	List a repository’s secret scanning alerts (leaked credentials).
github_get_secret_scanning_alert	Get one secret scanning alert (metadata only — never the secret).
github_list_dependabot_alerts	List a repository’s Dependabot alerts (vulnerable dependencies).
github_get_dependabot_alert	Get one Dependabot alert (advisory, vulnerable range, fix version).

---

Good to know

• Destructive actions are gated. Repository deletion refuses to run without an explicit confirmation, and new repositories are created private by default.
• Responses are shaped for agents. List tools return compact summary cards by default (a full mode is available), and heavyweight payloads — diffs, CI logs, big file trees — are capped and truncatable rather than dumped whole.
• Secret-scanning alerts never expose the leaked value. Your agent sees the secret’s type, state, and validity — never the credential itself.
• A 404 can mean “private”. GitHub deliberately answers 404 for private resources the token can’t see, so a “not found” on something that exists usually means the token’s repository grants need widening.

All providers Browse every connected provider.

System tools The discovery and connection tools every agent gets.