Skip to main content
Glama
github-mcp-server-js

github-mcp-server-js

by wuqunfei

Built exclusively on the two first-party SDKs from the official providers โ€” no custom HTTP client, no hand-rolled protocol layer:

  • ๐Ÿ™ Octokit.js โ€” GitHub's official REST/GraphQL client. Every tool in this server is a thin, typed wrapper around a verified octokit.rest.* method.

  • ๐Ÿค– MCP TypeScript โ€” Anthropic's official Model Context Protocol server SDK.

โœจ Highlights

  • ๐Ÿงฐ Complete surface โ€” 100+ tools across 16 toolsets (issues, pull requests, actions, code security, Copilot admin, ProjectsV2, and more).

  • ๐Ÿ”’ Secure by default โ€” flip GITHUB_PERMISSION=read-only and every mutating tool is never even registered.

  • ๐Ÿ“ฆ Three install channels โ€” npm (npx), Claude Desktop Extension (.mcpb), or unpacked extension (.zip).

  • โœ… Signed releases โ€” every version built by GitHub Actions with npm provenance and Sigstore attestation.

  • ๐Ÿงช Three-tier test suite โ€” 200+ hermetic unit tests (nock-mocked) plus a 25-assertion read-only integration suite and 2 state-preserving write round-trips against the real GitHub API.

  • ๐Ÿชถ Zero heavy runtime โ€” pure Node 24+, no Docker, no Go, single-file bundle (~2 MB).


Related MCP server: mcp-server-github

๐Ÿ’ก Why this project exists

Five gaps in the current GitHub-MCP landscape:

  • ๐Ÿข No remote MCP on enterprise GitHub. GHES and most managed enterprise deployments don't yet expose a remote MCP endpoint โ€” run a local server yourself.

  • ๐Ÿ—„๏ธ The Anthropic reference server is deprecated. @modelcontextprotocol/server-github is archived. No fixes, no new tools.

  • ๐Ÿณ The newer official server needs Docker + Go. github/github-mcp-server ships as a Docker-run Go binary โ€” often blocked by enterprise policy.

  • ๐Ÿงฐ Broader tool coverage. 100+ tools across 16 toolsets โ€” a superset of the archived server-github and typical gh-CLI wrappers. See Toolsets for the full list.

  • ๐Ÿ”’ Read-only mode is one env var. GITHUB_PERMISSION=read-only registers only the 76 read tools; the 30 mutating operations (create_issue, merge_pull_request, star_repo, run_workflow, โ€ฆ) are never exposed to the model. Same binary, one variable, verified by tests.

github-mcp-server-js fills all five โ€” pure Node 24+ / TypeScript, single-file bundle, npx-installable, shipped as both an npm package and a Claude Desktop Extension.


๐Ÿš€ Quick start

Pick one of three install paths, from easiest to most hands-on.

โšก Path 1 โ€” npx from Claude Desktop config (recommended for CLI users)

Edit your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this entry (create the file with { "mcpServers": {} } if it doesn't exist):

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "github-mcp-server-js"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_personal_access_token_here",
        "GITHUB_SERVER_URL": "github.com",
        "GITHUB_PERMISSION": "read-write",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Only GITHUB_TOKEN is required โ€” the other three are shown with their defaults so you can see every knob at a glance. Common adjustments:

  • GitHub Enterprise Server: "GITHUB_SERVER_URL": "github.mycompany.com" (bare hostname is fine; the server appends /api/v3 automatically).

  • Read-only mode: "GITHUB_PERMISSION": "read-only" โ€” the 30 mutating tools (create_issue, merge_pull_request, star_repo, run_workflow, โ€ฆ) are never registered.

  • Verbose logs: "LOG_LEVEL": "debug" prints every request/response summary to stderr; Claude Desktop surfaces stderr in its MCP log. Every line is already JSON โ€” no separate format flag needed.

Restart Claude Desktop. All 100+ tools become available in every new chat.

The server can also run standalone from any terminal:

npx github-mcp-server-js                                # stdio (for MCP clients)
npx github-mcp-server-js --transport=http --port=3000   # standalone HTTP

๐Ÿ–ฑ๏ธ Path 2 โ€” Claude Desktop Extension via drag-drop (.mcpb)

No config-file editing required; the token is stored in the OS keychain.

  1. Download github-mcp-server-js-<version>.mcpb from the latest GitHub Release.

  2. Open Claude Desktop โ†’ Settings โ†’ Extensions.

  3. Drag the .mcpb file into the Extensions pane.

  4. Fill in your GITHUB_TOKEN (masked; stored in the macOS / Windows keychain, never in plaintext). The remaining fields carry sensible defaults.

  5. Click Install. All 100+ tools are immediately available.

๐Ÿ› ๏ธ Path 3 โ€” Claude Desktop unpacked extension (.zip, developer mode)

Claude Desktop also supports loading an unpacked extension from a directory. This is useful when you want to inspect the manifest, hot-swap dist/cli.js, or work behind a corporate proxy that blocks .mcpb downloads.

  1. Download github-mcp-server-js-<version>.zip from the latest GitHub Release. The archive is byte-identical to the .mcpb; only the extension differs so stock unzip tooling can open it.

  2. Extract: unzip github-mcp-server-js-<version>.zip -d github-mcp-server-js.

  3. In Claude Desktop โ†’ Settings โ†’ Extensions, enable developer mode if it isn't already on.

  4. Click Install unpacked extension and select the extracted directory.

  5. Fill in GITHUB_TOKEN as in Path 2.

Edits to manifest.json or dist/cli.js in the extracted directory take effect on the next Claude Desktop reload โ€” useful for local iteration on a fork.

๐Ÿ—๏ธ Build the bundles yourself

git clone https://github.com/wuqunfei/github-mcp-server-js
cd github-mcp-server-js
npm ci
npm run pack:mcpb
# โ†’ dist/github-mcp-server-js-<version>.mcpb
# โ†’ dist/github-mcp-server-js-<version>.zip  (byte-identical copy)

โš™๏ธ Configuration

Configuration is entirely via environment variables. Claude Desktop sets them from the .mcpb user-config form; for npx installs you set them yourself.

Variable

Required

Default

Description

GITHUB_TOKEN

Yes

โ€”

Personal access token used for all GitHub API calls.

GITHUB_SERVER_URL

No

github.com

GitHub host โ€” bare hostname or full API base URL. Set this for GitHub Enterprise Server.

GITHUB_PERMISSION

No

read-write

read-only (registers 76 read tools) or read-write (all 100+).

LOG_LEVEL

No

info

debug, info, or error. Every tool call logs tool_call / tool_ok / tool_error as one JSON object per stderr line, plus an MCP notifications/message for the connected client.

๐Ÿงฐ Toolsets

All 16 toolsets are shipped, exposing 100+ tools total. Write tools are only registered when GITHUB_PERMISSION=read-write (the default); read-only mode registers the read tools alone. The Access column indicates: R = registered in read-only mode; W = registered only in read-write mode.

๐Ÿ“ repos โ€” repositories, branches, commits, tags, file contents

Tool

Access

Description

get_repository

R

Get a GitHub repository by owner and name.

list_branches

R

List branches in a repository.

get_branch

R

Get a single branch in a repository.

get_file_contents

R

Get the contents of a file or directory in a repository.

list_commits

R

List commits in a repository.

get_commit

R

Get a single commit in a repository.

list_tags

R

List tags in a repository.

get_tree

R

Get a single tree in a repository, optionally recursive.

create_or_update_file

W

Create a new file or update an existing file in a repository.

create_branch

W

Create a new branch from an existing branch or commit SHA.

delete_branch

W

Delete a branch from a repository.

create_tree

W

Create a new tree object in a repository.

๐Ÿ› issues โ€” issue CRUD, comments, labels, conversation locking

Tool

Access

Description

list_issues

R

List issues in a repository.

get_issue

R

Get a single issue in a repository.

list_comments

R

List comments on an issue.

list_labels

R

List all labels defined in a repository.

list_labels_on_issue

R

List the labels currently applied to an issue.

create_issue

W

Create a new issue in a repository.

update_issue

W

Update an existing issue.

add_comment

W

Add a comment to an issue.

add_labels

W

Add labels to an issue, keeping the issue's existing labels.

remove_label

W

Remove a single label from an issue.

lock_issue

W

Lock an issue conversation to collaborators only.

unlock_issue

W

Unlock a previously locked issue conversation.

๐Ÿ”€ pull_requests โ€” PR listing, creation, merging, reviews

Tool

Access

Description

list_pull_requests

R

List pull requests in a repository.

get_pull_request

R

Get a single pull request.

list_pull_request_files

R

List the files changed in a pull request.

list_pull_request_commits

R

List the commits on a pull request.

list_pull_request_reviews

R

List the reviews on a pull request.

create_pull_request

W

Create a new pull request.

update_pull_request

W

Update an existing pull request.

merge_pull_request

W

Merge a pull request.

create_pull_request_review

W

Create a review on a pull request.

request_reviewers

W

Request reviewers for a pull request.

๐Ÿ”Ž search โ€” repo, code, commit, issue/PR, user search

Tool

Access

Description

search_repos

R

Search GitHub repositories. q accepts GitHub search qualifiers (e.g. stars:>100 language:go).

search_code

R

Search code across GitHub. q accepts code-search qualifiers (e.g. repo:foo/bar in:file).

search_commits

R

Search commits on default branches. q accepts commit-search qualifiers.

search_issues

R

Search issues and pull requests (scope with is:issue or is:pull-request).

search_users

R

Search GitHub users.

๐Ÿ‘ค users โ€” profiles, followers, following, hovercard

Tool

Access

Description

get_user_by_username

R

Get public information about a user by login.

get_authenticated_user

R

Get the profile of the currently authenticated user (owner of GITHUB_TOKEN).

list_user_followers

R

List the users who follow a given user.

list_user_following

R

List the users that a given user follows.

get_user_hovercard

R

Get contextual "hovercard" information about a user, optionally scoped to a subject.

๐Ÿ“ gists โ€” list, get, create, update, delete gists

Tool

Access

Description

list_gists

R

List gists for the authenticated user.

get_gist

R

Get a single gist by id (full file content included).

create_gist

W

Create a new gist (one or more files, public or secret).

update_gist

W

Update an existing gist: change description, add/rename/delete files.

delete_gist

W

Delete a gist (permanent โ€” only the owner can delete).

๐Ÿ”” activity โ€” notifications, starred repos, star/unstar

Tool

Access

Description

list_notifications

R

List notifications for the authenticated user (paginated, max 50/page).

list_starred_repos

R

List repositories starred by the authenticated user.

check_repo_starred

R

Check whether the authenticated user has starred a repository. Returns { starred: boolean }.

star_repo

W

Star a repository on behalf of the authenticated user.

unstar_repo

W

Unstar a repository the authenticated user previously starred.

๐Ÿ“ฆ packages โ€” GitHub Packages owned by the authenticated user

Requires the read:packages token scope. package_type is required and must be one of npm, maven, rubygems, docker, nuget, container.

Tool

Access

Description

list_packages_for_authenticated_user

R

List packages owned by the authenticated user for a given package type.

get_package_for_authenticated_user

R

Get a specific package owned by the authenticated user.

list_package_versions_for_authenticated_user

R

List all versions of a package owned by the authenticated user.

get_package_version_for_authenticated_user

R

Get a specific version of a package owned by the authenticated user.

๐Ÿ”ง misc โ€” utility endpoints

Tool

Access

Description

get_rate_limit

R

Get the current API rate-limit status for the authenticated user.

get_meta

R

Get GitHub API metadata: IP ranges, SSH keys, and service host info.

list_emojis

R

List all emoji names and their image URLs available on GitHub.

render_markdown

R

Render a Markdown string to HTML using GitHub's renderer (returns raw HTML).

๐Ÿ”Œ apps โ€” GitHub App public info and user installations

Tool

Access

Description

get_app

R

Get public metadata for a GitHub App by URL slug.

list_installations_for_authenticated_user

R

List GitHub App installations accessible to the authenticated user.

list_installation_repos_for_authenticated_user

R

List repositories the authenticated user can access under a specific installation.

๐Ÿช„ copilot โ€” Copilot org-admin (org-owner PAT required)

Tool

Access

Description

get_copilot_organization_details

R

Get Copilot seat breakdown and policy settings for an organization.

list_copilot_seats

R

List all Copilot seat assignments in an organization.

get_copilot_seat_details_for_user

R

Get Copilot seat details (last activity, editor) for a specific org member.

๐Ÿข orgs_teams โ€” organization inspection and team membership

Tool

Access

Description

get_org

R

Get a GitHub organization by login.

list_org_members

R

List members of an organization.

list_org_repos

R

List repositories in an organization.

list_teams

R

List teams in an organization.

get_team_by_name

R

Get a team by its slug within an organization.

list_team_members

R

List the members of a team.

add_or_update_team_membership

W

Add a user to a team or update their role (requires org-owner or team-maintainer).

remove_team_membership

W

Remove a user from a team (requires org-owner or team-admin).

๐Ÿ’ป codespaces โ€” user codespace lifecycle

Tool

Access

Description

list_codespaces

R

List codespaces for the authenticated user.

get_codespace

R

Get a codespace by name for the authenticated user.

create_codespace_in_repo

W

Create a codespace in a repository for the authenticated user.

start_codespace

W

Start a stopped codespace.

stop_codespace

W

Stop a running codespace.

๐Ÿ“‹ projects โ€” GitHub ProjectsV2 (org-scoped, read-only)

Tool

Access

Description

list_org_projects

R

List ProjectsV2 projects in an organization.

get_org_project

R

Get a ProjectsV2 project by its number.

list_org_project_items

R

List items in a ProjectsV2 project.

list_org_project_fields

R

List fields configured on a ProjectsV2 project.

get_org_project_item

R

Get a single item in a ProjectsV2 project.

๐Ÿ›ก๏ธ code_security โ€” code scanning, secrets, Dependabot, advisories

Alert-inspection tools require the security_events PAT scope (or public_repo for public repositories).

Tool

Access

Description

list_code_scanning_alerts

R

List code-scanning alerts for a repository.

get_code_scanning_alert

R

Get a code-scanning alert.

list_secret_scanning_alerts

R

List secret-scanning alerts for a repository.

get_secret_scanning_alert

R

Get a secret-scanning alert.

list_dependabot_alerts

R

List Dependabot alerts for a repository.

get_dependabot_alert

R

Get a Dependabot alert.

list_global_advisories

R

List GitHub Global Security Advisories (public GHSA database).

get_global_advisory

R

Get a global GitHub security advisory by GHSA ID.

list_repository_advisories

R

List repository security advisories.

get_repository_advisory

R

Get a repository security advisory by GHSA ID.

๐ŸŽฌ actions โ€” workflows, runs, jobs, artifacts, check runs

Tool

Access

Description

list_workflows

R

List workflows in a repository.

get_workflow

R

Get a workflow by ID or filename (e.g. ci.yml).

list_workflow_runs

R

List runs for a workflow (filter by status, branch, event, actor).

get_workflow_run

R

Get a workflow run by ID.

list_workflow_run_jobs

R

List jobs for a workflow run.

list_workflow_run_artifacts

R

List artifacts produced by a workflow run.

list_check_runs_for_ref

R

List check runs for a Git ref (SHA, branch, or tag).

run_workflow

W

Trigger a workflow_dispatch event for a workflow.

cancel_workflow_run

W

Cancel a workflow run.

rerun_workflow_run

W

Re-run a workflow run.

rerun_workflow_run_failed_jobs

W

Re-run only the failed jobs in a workflow run.

approve_workflow_run

W

Approve a workflow run awaiting fork-PR approval.

๐Ÿงช Testing

The suite is organized in three tiers, each with a distinct purpose and different guarantees. All three run against the same source; only the network scope and the presence of GITHUB_TOKEN differ.

1. Unit tests โ€” hermetic, mocked

  • Location: test/unit/

  • Count: 200 +

  • Network: none (nock intercepts every HTTP call; test/setup.ts disables outbound connections so an accidental live call fails loudly)

  • Runtime: ~1.3 seconds

  • When it runs: on every commit via the pre-commit hook and every push via CI

npm test

2. Integration tests โ€” read-only, real API

  • Location: test/integration/read-only.test.ts

  • Count: 25 assertions across all 16 toolsets against stable public targets (octocat/Hello-World, octokit/octokit.js)

  • Network: hits api.github.com โ€” spawns the built dist/cli.js over stdio, exactly as a real MCP client would

  • Safety: read-only โ€” no state mutations anywhere

  • Skip behavior: if GITHUB_TOKEN is missing, the whole suite is describe.skip'd so CI without a token stays green

GITHUB_TOKEN=ghp_... npm run test:integration

3. Integration tests โ€” read + write, real API, opt-in

  • Location: test/integration/write.test.ts (plus everything in tier 2)

  • Count: all 25 read-only assertions + 2 write round-trips

  • Round-trips (state-preserving):

    1. create_gist โ†’ get_gist โ†’ update_gist โ†’ delete_gist on a scratch gist โ€” asserts the deleted gist 404s after cleanup

    2. star_repo / unstar_repo on a public repo, restoring the prior starred state whichever way it started

  • Opt-in gate: requires INTEGRATION_WRITE=1 โ€” the write suite is describe.skip'd otherwise, so it never mutates state by accident

INTEGRATION_WRITE=1 GITHUB_TOKEN=ghp_... npm run test:integration:write

Both integration scripts run npm run build first so the tests exercise the built dist/cli.js over stdio, matching real client usage exactly.

๐Ÿ” Build your own bundle (zero trust)

Prefer not to trust binaries we publish? Every release artifact is fully reproducible from source. You audit the code, run the same gates our CI runs, and produce your own .mcpb and .zip โ€” no need to trust the SHA-256 on our GitHub Releases page or the npm registry.

Prerequisites

  • Node.js 24+ โ€” verify with node --version

  • npm โ€” bundled with Node 24 (currently npm 11.x); no separate install

  • git

Full audit + build pipeline

# 1. Clone the repo at the exact release tag you want to reproduce.
git clone https://github.com/wuqunfei/github-mcp-server-js
cd github-mcp-server-js
git checkout v0.1.1

# 2. Audit the code. Nothing is executed yet.
git log --stat v0.1.0..v0.1.1        # review commits between releases
# Or open the tree in your editor and read every changed file.

# 3. Install the exact dependency versions recorded in package-lock.json.
#    No transitive drift, no surprise upgrades.
npm ci

# 4. Run the same gate our release CI runs. Any failure means don't ship.
npm run typecheck
npm run lint
npm run spellcheck
npm audit --audit-level=high
npm test

# 5. Build the self-contained CLI. Every runtime dependency is inlined
#    into a single ~1.85 MB file โ€” nothing loaded from node_modules at runtime.
npm run build                         # โ†’ dist/cli.js

# 6. Pack the extension. The pack script:
#      - enforces manifest.json.version === package.json.version
#      - validates manifest.json against the .mcpb v0.1 schema
#      - re-runs the build for freshness
#      - packs and then unpacks the archive to assert exactly the three
#        expected entries (manifest.json, dist/cli.js, assets/icon.png)
npm run pack:mcpb
# โ†’ dist/github-mcp-server-js-<version>.mcpb
# โ†’ dist/github-mcp-server-js-<version>.zip   (byte-identical copy)

Install your locally built bundle

Drag the resulting .mcpb (or the extracted .zip) into Claude Desktop โ†’ Settings โ†’ Extensions exactly as in Path 2 or Path 3.

Note on byte reproducibility. The SHA-256 of your local .mcpb may differ from our published artifact because zip entries encode file modification timestamps. The contents are identical when you build from the same commit with the same locked dependencies. To compare content, use npx @anthropic-ai/mcpb unpack <file> <dir> on both archives and diff the extracted trees.

๐Ÿšข Releases and provenance

Every published version is built by GitHub Actions from a tagged commit, signed with npm's Trusted Publisher and Sigstore attestation, and shipped as three artifacts:

  • ๐Ÿ“ฆ npm package โ€” npm i github-mcp-server-js (installs the bundled dist/cli.js).

  • ๐Ÿงฉ .mcpb Claude Desktop Extension โ€” drag-drop install (Path 2).

  • ๐Ÿ—œ๏ธ .zip alternate archive โ€” byte-identical to the .mcpb; used for the unpacked-extension flow (Path 3) and stock unzip inspection.

๐Ÿ™ Credits

๐Ÿ“„ License

MIT ยฉ 2026 Qunfei Wu. See LICENSE.

Available Tools

108 tools
add_commentA

Inputs: body (required), repo (required), owner (required), issue_number (required).

add_labelsA

Add labels to a GitHub issue, keeping the issue's existing labels. Docs: https://docs.github.com/en/rest/issues/labels#add-labels-to-an-issue

Inputs: repo (required), owner (required), labels (required), issue_number (required).

add_or_update_team_membershipA

Add a user to a team or update their team role. Requires org-owner or team-maintainer permission. Docs: https://docs.github.com/en/rest/teams/members#add-or-update-team-membership-for-a-user

Inputs: org (required), username (required), team_slug (required), role.

approve_workflow_runA

Inputs: repo (required), owner (required), run_id (required).

cancel_workflow_runB

Inputs: repo (required), owner (required), run_id (required).

check_repo_starredA

Check whether the authenticated user has starred a given repository. Returns { starred: true } if the repository is starred, or { starred: false } if it is not. Never returns an error for a 404 (not-starred) response โ€” only errors on authentication failures (401/403) or truly unexpected conditions. Docs: https://docs.github.com/en/rest/activity/starring#check-if-a-repository-is-starred-by-the-authenticated-user

Inputs: repo (required), owner (required).

create_branchA

Create a new branch in a GitHub repository from an existing branch or commit SHA. Docs: https://docs.github.com/en/rest/git/refs#create-a-reference

Inputs: from (required), repo (required), owner (required), branch (required).

create_codespace_in_repoA

Create a codespace in a repository for the authenticated user. Docs: https://docs.github.com/en/rest/codespaces/codespaces#create-a-codespace-in-a-repository

Inputs: repo (required), owner (required), ref, machine, +4 more.

create_gistA

Create a new gist. A gist is a shareable snippet or small file. Supply one or more files with their content; each file key is the filename (including extension). Set public to true to make the gist visible to all GitHub users, or false (default) for a secret gist (unlisted but accessible by direct URL). Docs: https://docs.github.com/en/rest/gists/gists#create-a-gist

Inputs: files (required), public, description.

create_issueB

Create a new issue in a GitHub repository. Docs: https://docs.github.com/en/rest/issues/issues#create-an-issue

Inputs: repo (required), owner (required), title (required), body, +2 more.

create_or_update_fileB

Create a new file or update an existing file in a GitHub repository. Docs: https://docs.github.com/en/rest/repos/contents#create-or-update-file-contents

Inputs: path (required), repo (required), owner (required), content (required), +3 more.

create_pull_requestB

Create a new pull request in a GitHub repository. Docs: https://docs.github.com/en/rest/pulls/pulls#create-a-pull-request

Inputs: base (required), head (required), repo (required), owner (required), +5 more.

create_pull_request_reviewB

Inputs: repo (required), owner (required), pull_number (required), body, +2 more.

create_treeA

Create a new tree object in a GitHub repository from a set of tree entries, optionally based on an existing tree. Docs: https://docs.github.com/en/rest/git/trees#create-a-tree

Inputs: repo (required), tree (required), owner (required), base_tree.

delete_branchA

Delete a branch from a GitHub repository. This action is permanent and cannot be undone. Docs: https://docs.github.com/en/rest/git/refs#delete-a-reference

Inputs: repo (required), owner (required), branch (required).

delete_gistA

Delete a gist. This action is permanent and cannot be undone. Only the gist owner can delete it. Docs: https://docs.github.com/en/rest/gists/gists#delete-a-gist

Inputs: gist_id (required).

get_appA

Get public metadata for a GitHub App by its URL slug.Returns the app's id, name, description, owner, external URL, permissions, subscribed events, and installation count. Does not require authentication โ€” the app must be publicly listed. The slug is the URL-friendly name visible in github.com/apps/. Docs: https://docs.github.com/en/rest/apps/apps#get-an-app

Inputs: app_slug (required).

get_authenticated_userA

Get the profile of the currently authenticated user (the owner of the GITHUB_TOKEN in use). Returns the same public fields as get_user_by_username plus private fields (private_gists, total_private_repos, plan, etc.) that are visible only to the token owner, subject to token scope. Docs: https://docs.github.com/en/rest/users/users#get-the-authenticated-user

Inputs: no named parameters.

get_branchB

Get a single branch in a GitHub repository. Docs: https://docs.github.com/en/rest/branches/branches#get-a-branch

Inputs: repo (required), owner (required), branch (required).

get_code_scanning_alertA

Get a code-scanning alert. Requires security_events PAT scope (private) or public_repo (public). Docs: https://docs.github.com/en/rest/code-scanning/code-scanning#get-a-code-scanning-alert

Inputs: repo (required), owner (required), alert_number (required).

get_codespaceA

Inputs: codespace_name (required).

get_commitA

Get a single commit in a GitHub repository. Docs: https://docs.github.com/en/rest/commits/commits#get-a-commit

Inputs: ref (required), repo (required), owner (required).

get_copilot_organization_detailsA

Get GitHub Copilot seat information and policy settings for an organization.Returns seat breakdown (total, active, inactive, pending cancellation, pending invitation, added this cycle), subscription plan type (business or enterprise), and policy settings (public code suggestions filter, IDE chat, platform chat, CLI enablement, seat management mode). Requires the authenticated user to be an organization owner. Requires a token with manage_billing:copilot or read:org scope. Returns 404 if the organization does not have a Copilot Business or Enterprise subscription. Returns 403 if the token lacks sufficient scope or the user is not an org owner. Docs: https://docs.github.com/en/rest/copilot/copilot-user-management#get-copilot-seat-information-and-settings-for-an-organization

Inputs: org (required).

get_copilot_seat_details_for_userA

Get GitHub Copilot seat assignment details for a specific member of an organization.Returns the seat creation date, last Copilot activity timestamp, last editor used, last authentication timestamp, pending cancellation date (if applicable), the team or organization granting access, and the Copilot plan type. Only returns results for users who currently have an active Copilot seat. Users must have telemetry enabled in their IDE for activity data to be populated. Requires the authenticated user to be an organization owner. Requires a token with manage_billing:copilot or read:org scope. Returns 404 if the user does not have a Copilot seat in this organization, or if the organization does not have a Copilot subscription. Returns 403 if the token lacks sufficient scope or the user is not an org owner. Docs: https://docs.github.com/en/rest/copilot/copilot-user-management#get-copilot-seat-assignment-details-for-a-user

Inputs: org (required), username (required).

get_dependabot_alertA

Get a Dependabot alert. Requires security_events PAT scope. Docs: https://docs.github.com/en/rest/dependabot/alerts#get-a-dependabot-alert

Inputs: repo (required), owner (required), alert_number (required).

get_file_contentsB

Get the contents of a file or directory in a GitHub repository. Docs: https://docs.github.com/en/rest/repos/contents#get-repository-content

Inputs: path (required), repo (required), owner (required), ref.

get_gistA

Get a single gist by its id. Returns a gist-simple object with full file content, description, public flag, owner, forks_url, commits_url, and history. File content is included inline (up to the truncation threshold โ€” very large files include a raw_url instead). Docs: https://docs.github.com/en/rest/gists/gists#get-a-gist

Inputs: gist_id (required).

get_global_advisoryA

Inputs: ghsa_id (required).

get_issueA

Get a single issue in a GitHub repository. Docs: https://docs.github.com/en/rest/issues/issues#get-an-issue

Inputs: repo (required), owner (required), issue_number (required).

get_metaA

Get GitHub API metadata: IP address ranges for GitHub services(hooks, web, api, git, packages, pages, importer, actions, dependabot, copilot), SSH key fingerprints, SSH public keys used to sign GitHub commits, and whether GitHub password authentication is enabled. Useful for firewall allowlisting, SSH host verification, and infrastructure automation. Returns an api-overview object. Safe to call without authentication. Docs: https://docs.github.com/en/rest/meta/meta#get-github-meta-information

Inputs: no named parameters.

get_orgA

Get a GitHub organization by login. Docs: https://docs.github.com/en/rest/orgs/orgs#get-an-organization

Inputs: org (required).

get_org_projectB

Get a GitHub ProjectsV2 project by number in an organization. Docs: https://docs.github.com/en/rest/projects/projects

Inputs: org (required), project_number (required).

get_org_project_itemA

Get a single item in a GitHub ProjectsV2 project. Docs: https://docs.github.com/en/rest/projects/items

Inputs: org (required), item_id (required), project_number (required).

get_package_for_authenticated_userA

Get a specific package owned by the authenticated user.Returns the package metadata including name, type, version count, visibility, repository link, and timestamps. Requires the read:packages token scope. Docs: https://docs.github.com/en/rest/packages/packages#get-a-package-for-the-authenticated-user

Inputs: package_name (required), package_type (required).

get_package_version_for_authenticated_userA

Get a specific version of a package owned by the authenticated user.Returns the package-version object including the version id, name, creation/update timestamps, and type-specific metadata. Use list_package_versions_for_authenticated_user to find version ids. Requires the read:packages token scope. Docs: https://docs.github.com/en/rest/packages/packages#get-a-package-version-for-the-authenticated-user

Inputs: package_name (required), package_type (required), package_version_id (required).

get_pull_requestA

Get a single pull request in a GitHub repository. Docs: https://docs.github.com/en/rest/pulls/pulls#get-a-pull-request

Inputs: repo (required), owner (required), pull_number (required).

get_rate_limitA

Get the current API rate limit status for the authenticated user.Returns a rate-limit-overview object with per-category breakdowns (core, search, graphql, code_search, actions_runner_registration, etc.), each showing limit, used, remaining, and reset timestamp (Unix epoch seconds). Accessing this endpoint does not itself consume any rate limit quota. Docs: https://docs.github.com/en/rest/rate-limit/rate-limit#get-rate-limit-status-for-the-authenticated-user

Inputs: no named parameters.

get_repositoryB

Get a GitHub repository by owner and name. Docs: https://docs.github.com/en/rest/repos/repos#get-a-repository

Inputs: repo (required), owner (required).

get_repository_advisoryA

Inputs: repo (required), owner (required), ghsa_id (required).

get_secret_scanning_alertA

Get a secret-scanning alert. Requires security_events PAT scope. Docs: https://docs.github.com/en/rest/secret-scanning/secret-scanning#get-a-secret-scanning-alert

Inputs: repo (required), owner (required), alert_number (required).

get_team_by_nameA

Get a GitHub team by its slug within an organization. Docs: https://docs.github.com/en/rest/teams/teams#get-a-team-by-name

Inputs: org (required), team_slug (required).

get_treeA

Get a single tree in a GitHub repository using the SHA1 value or ref name for that tree. Docs: https://docs.github.com/en/rest/git/trees#get-a-tree

Inputs: repo (required), owner (required), tree_sha (required), recursive.

get_user_by_usernameA

Get publicly available information about a GitHub user by their login (username). Returns profile data including name, bio, location, public repo count, follower count, and following count. Returns a 404 if the user does not exist or is an Enterprise Managed User not visible to the caller. Docs: https://docs.github.com/en/rest/users/users#get-a-user

Inputs: username (required).

get_user_hovercardA

Get contextual information about a GitHub user (their "hovercard") as it would appear in the GitHub web UI. Returns a list of context messages (e.g. "Owns this repository", "Contributor"). Optionally scope the context to a specific subject (a repository, issue, pull request, or organization) by providing subject_type and subject_id together โ€” both are required when either is supplied. Docs: https://docs.github.com/en/rest/users/users#get-contextual-information-for-a-user

Inputs: username (required), subject_id, subject_type.

get_workflowA

Inputs: repo (required), owner (required), workflow_id (required).

get_workflow_runB

Inputs: repo (required), owner (required), run_id (required).

list_branchesB

List branches in a GitHub repository. Docs: https://docs.github.com/en/rest/branches/branches#list-branches

Inputs: repo (required), owner (required), page, per_page.

list_check_runs_for_refA

List check runs for a Git ref (SHA, branch, or tag). Docs: https://docs.github.com/en/rest/checks/runs#list-check-runs-for-a-git-reference

Inputs: ref (required), repo (required), owner (required), page, +4 more.

list_code_scanning_alertsA

List code-scanning alerts for a repository. Requires security_events PAT scope for private repos, public_repo for public. Docs: https://docs.github.com/en/rest/code-scanning/code-scanning#list-code-scanning-alerts-for-a-repository

Inputs: repo (required), owner (required), ref, page, +5 more.

list_codespacesA

Inputs: page, per_page, repository_id.

list_commentsB

Inputs: repo (required), owner (required), issue_number (required), page, +1 more.

list_commitsC

List commits in a GitHub repository. Docs: https://docs.github.com/en/rest/commits/commits#list-commits

Inputs: repo (required), owner (required), sha, page, +2 more.

list_copilot_seatsA

List all GitHub Copilot seat assignments for an organization.Returns each assigned seat with the assignee user details, the team or organization through which access was granted, the seat creation date, last Copilot activity timestamp, last editor used, and pending cancellation date if applicable. Requires the authenticated user to be an organization owner. Requires a token with manage_billing:copilot or read:org scope. Returns 404 if the organization does not have a Copilot subscription. Returns 403 if the token lacks sufficient scope or the user is not an org owner. Paginate with page and per_page (default 30, max 100). Docs: https://docs.github.com/en/rest/copilot/copilot-user-management#list-all-copilot-seat-assignments-for-an-organization

Inputs: org (required), page, per_page.

list_dependabot_alertsA

List Dependabot alerts for a repository. Requires security_events PAT scope. Docs: https://docs.github.com/en/rest/dependabot/alerts#list-dependabot-alerts-for-a-repository

Inputs: repo (required), owner (required), page, state, +4 more.

list_emojisA

List all emoji names available to use on GitHub, with their corresponding image URLs.Returns a flat JSON object mapping each emoji name (e.g. "smile", "+1", "octocat") to its CDN image URL on github.githubassets.com. Useful for populating emoji pickers, validating emoji names, or fetching emoji images. Docs: https://docs.github.com/en/rest/emojis/emojis#get-emojis

Inputs: no named parameters.

list_gistsA

List gists for the authenticated user. Returns an array of base-gist objects including id, description, public flag, file list (names and metadata, but not full content), and owner. Paginate with page and per_page. To get full file content for a specific gist, call get_gist with its id. Docs: https://docs.github.com/en/rest/gists/gists#list-gists-for-the-authenticated-user

Inputs: page, since, per_page.

list_global_advisoriesB

List GitHub Global Security Advisories from the public GHSA database. Docs: https://docs.github.com/en/rest/security-advisories/global-advisories#list-global-security-advisories

Inputs: cwes, page, type, per_page, +2 more.

list_installation_repos_for_authenticated_userA

List repositories that the authenticated user can access for a specific GitHub App installation.Returns repositories where the user has explicit read, write, or admin permission through direct ownership, collaborator access, or organization membership. Use list_installations_for_authenticated_user to discover installation IDs first. Paginate with page and per_page. Docs: https://docs.github.com/en/rest/apps/installations#list-repositories-accessible-to-the-user-access-token

Inputs: installation_id (required), page, per_page.

list_installations_for_authenticated_userA

List GitHub App installations accessible to the authenticated user.Returns installations on the user's personal account and on organizations where the user is a member, along with the permissions and events each installation subscribes to. Useful for discovering which apps are installed and their installation IDs (needed for list_installation_repos_for_authenticated_user). Requires a token with read:user scope or higher. Paginate with page and per_page. Docs: https://docs.github.com/en/rest/apps/installations#list-app-installations-accessible-to-the-user-access-token

Inputs: page, per_page.

list_issuesB

Inputs: repo (required), owner (required), page, sort, +5 more.

list_labelsA

List all labels defined in a GitHub repository. Docs: https://docs.github.com/en/rest/issues/labels#list-labels-for-a-repository

Inputs: repo (required), owner (required), page, per_page.

list_labels_on_issueA

List the labels currently applied to a GitHub issue. Docs: https://docs.github.com/en/rest/issues/labels#list-labels-for-an-issue

Inputs: repo (required), owner (required), issue_number (required), page, +1 more.

list_notificationsA

List notifications for the authenticated user. Returns an array of thread objects representing unread (or all) notifications. Each thread includes the subject (title, type, URL), repository, reason, and updated_at timestamp. Use all=true to include already-read notifications. Paginate with page and per_page (max 50 per page โ€” GitHub caps this endpoint at 50, not the usual 100). Docs: https://docs.github.com/en/rest/activity/notifications#list-notifications-for-the-authenticated-user

Inputs: all, page, since, before, +2 more.

list_org_membersA

Inputs: org (required), page, role, filter, +1 more.

list_org_project_fieldsB

List fields configured on a GitHub ProjectsV2 project. Docs: https://docs.github.com/en/rest/projects/fields

Inputs: org (required), project_number (required), page, per_page.

list_org_project_itemsB

List items in a GitHub ProjectsV2 project. Docs: https://docs.github.com/en/rest/projects/items

Inputs: org (required), project_number (required), page, per_page.

list_org_projectsC

List GitHub ProjectsV2 projects in an organization. Docs: https://docs.github.com/en/rest/projects/projects

Inputs: org (required), page, per_page.

list_org_reposB

List repositories in a GitHub organization. Docs: https://docs.github.com/en/rest/repos/repos#list-organization-repositories

Inputs: org (required), page, sort, type, +2 more.

list_packages_for_authenticated_userA

List packages owned by the authenticated user (the owner of GITHUB_TOKEN).Requires the read:packages token scope. The package_type filter is required โ€” pass one of npm, maven, rubygems, docker, nuget, or container. Optionally filter by visibility (public, private, internal). Paginate with page and per_page. Docs: https://docs.github.com/en/rest/packages/packages#list-packages-for-the-authenticated-users-namespace

Inputs: package_type (required), page, per_page, visibility.

list_package_versions_for_authenticated_userA

List all versions of a package owned by the authenticated user.Returns an array of package-version objects, each with an id, version name, creation/update timestamps, and type-specific metadata (e.g. container tags, npm dist-tags). Optionally filter by state: "active" (default) returns live versions; "deleted" returns versions that have been deleted but can still be restored within 30 days. Requires the read:packages token scope. Docs: https://docs.github.com/en/rest/packages/packages#list-package-versions-for-a-package-owned-by-the-authenticated-user

Inputs: package_name (required), package_type (required), page, state, +1 more.

list_pull_request_commitsB

Inputs: repo (required), owner (required), pull_number (required), page, +1 more.

list_pull_request_filesA

List the files changed in a GitHub pull request. Docs: https://docs.github.com/en/rest/pulls/pulls#list-pull-requests-files

Inputs: repo (required), owner (required), pull_number (required), page, +1 more.

list_pull_request_reviewsA

Inputs: repo (required), owner (required), pull_number (required), page, +1 more.

list_pull_requestsC

List pull requests in a GitHub repository. Docs: https://docs.github.com/en/rest/pulls/pulls#list-pull-requests

Inputs: repo (required), owner (required), base, head, +5 more.

list_repository_advisoriesB

Inputs: repo (required), owner (required), page, per_page.

list_secret_scanning_alertsA

List secret-scanning alerts for a repository. Requires security_events PAT scope. Docs: https://docs.github.com/en/rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-a-repository

Inputs: repo (required), owner (required), page, state, +3 more.

list_starred_reposA

List repositories starred by the authenticated user. Returns an array of repository objects including id, name, full_name, html_url, description, stargazers_count, language, and owner. Sort by created (when the user starred it) or updated (when the repo was last pushed to). Paginate with page and per_page. Docs: https://docs.github.com/en/rest/activity/starring#list-repositories-starred-by-the-authenticated-user

Inputs: page, sort, per_page, direction.

list_tagsB

Inputs: repo (required), owner (required), page, per_page.

list_team_membersC

Inputs: org (required), team_slug (required), page, role, +1 more.

list_teamsC

List teams in a GitHub organization. Docs: https://docs.github.com/en/rest/teams/teams#list-teams

Inputs: org (required), page, per_page.

list_user_followersA

List the users who follow a given GitHub user. Returns an array of simple-user objects, each with login, id, avatar_url, and html_url. Paginate with page and per_page. Docs: https://docs.github.com/en/rest/users/followers#list-followers-of-a-user

Inputs: username (required), page, per_page.

list_user_followingA

List the users that a given GitHub user follows. Returns an array of simple-user objects, each with login, id, avatar_url, and html_url. Paginate with page and per_page. Docs: https://docs.github.com/en/rest/users/followers#list-the-people-a-user-follows

Inputs: username (required), page, per_page.

list_workflow_run_artifactsB

Inputs: repo (required), owner (required), run_id (required), page, +1 more.

list_workflow_run_jobsB

Inputs: repo (required), owner (required), run_id (required), page, +2 more.

list_workflow_runsC

Inputs: repo (required), owner (required), workflow_id (required), page, +5 more.

list_workflowsC

Inputs: repo (required), owner (required), page, per_page.

lock_issueB

Lock a GitHub issue conversation to collaborators only. Docs: https://docs.github.com/en/rest/issues/issues#lock-an-issue

Inputs: repo (required), owner (required), issue_number (required), lock_reason.

merge_pull_requestB

Merge a pull request in a GitHub repository. Docs: https://docs.github.com/en/rest/pulls/pulls#merge-a-pull-request

Inputs: repo (required), owner (required), pull_number (required), sha, +3 more.

remove_labelB

Inputs: name (required), repo (required), owner (required), issue_number (required).

remove_team_membershipA

Remove a user from a team. Does not delete the user, only their team membership. Requires org-owner or team-admin permission. Docs: https://docs.github.com/en/rest/teams/members#remove-team-membership-for-a-user

Inputs: org (required), username (required), team_slug (required).

render_markdownA

Render a Markdown string to HTML using GitHub's Markdown renderer. Returns the rendered HTML as a plain text string (not JSON-encoded). Use mode "markdown" (default) for standard Markdown. Use mode "gfm" (GitHub Flavored Markdown) to enable cross-references such as #42 linking to issues and @mentions โ€” requires the context parameter to specify the repository (e.g. "owner/repo") for resolving those references. This endpoint is stateless: it renders and returns HTML without modifying any data. Docs: https://docs.github.com/en/rest/markdown/markdown#render-a-markdown-document

Inputs: text (required), mode, context.

request_reviewersB

Inputs: repo (required), owner (required), pull_number (required), reviewers, +1 more.

rerun_workflow_runC

Inputs: repo (required), owner (required), run_id (required), enable_debug_logging.

rerun_workflow_run_failed_jobsA

Inputs: repo (required), owner (required), run_id (required), enable_debug_logging.

run_workflowA

Trigger a workflow_dispatch event for a workflow. Docs: https://docs.github.com/en/rest/actions/workflows#create-a-workflow-dispatch-event

Inputs: ref (required), repo (required), owner (required), workflow_id (required), +1 more.

search_codeA

Search code across GitHub. The q parameter accepts GitHub code-search qualifiers (e.g. "addClass repo:jquery/jquery in:file language:js"). Sort and order are omitted because GitHub is closing down sortable code search; results are ranked by relevance. Docs: https://docs.github.com/en/rest/search/search#search-code

Inputs: q (required), page, per_page.

search_commitsA

Search commits on the default branch of repositories. The q parameter accepts GitHub commit-search qualifiers (e.g. "repo:octocat/Spoon-Knife css author:octocat"). Docs: https://docs.github.com/en/rest/search/search#search-commits

Inputs: q (required), page, sort, order, +1 more.

search_issuesA

Search GitHub issues AND pull requests. GitHub treats issues and pull requests as a single searchable resource; scope with is:issue or is:pull-request qualifiers inside q. Example q: "windows label:bug language:python state:open is:issue". Docs: https://docs.github.com/en/rest/search/search#search-issues-and-pull-requests

Inputs: q (required), page, sort, order, +1 more.

search_reposA

Search GitHub repositories via various criteria. The q parameter accepts GitHub search qualifiers (e.g. "tetris language:assembly stars:>100"). Returns up to 100 results per page; GitHub caps total results at 1000. Docs: https://docs.github.com/en/rest/search/search#search-repositories

Inputs: q (required), page, sort, order, +1 more.

search_usersA

Search GitHub users. Only returns publicly visible users. The q parameter accepts GitHub user-search qualifiers (e.g. "tom repos:>42 followers:>1000"). Docs: https://docs.github.com/en/rest/search/search#search-users

Inputs: q (required), page, sort, order, +1 more.

star_repoA

Star a repository on behalf of the authenticated user. Starring marks a repository as interesting and adds it to the authenticated user's starred list (visible via list_starred_repos). Returns { starred: true } on success. Returns an error if the repository does not exist or the token lacks sufficient scope. Docs: https://docs.github.com/en/rest/activity/starring#star-a-repository-for-the-authenticated-user

Inputs: repo (required), owner (required).

start_codespaceA

Inputs: codespace_name (required).

stop_codespaceA

Inputs: codespace_name (required).

unlock_issueA

Unlock a previously locked GitHub issue conversation. Docs: https://docs.github.com/en/rest/issues/issues#unlock-an-issue

Inputs: repo (required), owner (required), issue_number (required).

unstar_repoA

Unstar a repository that the authenticated user has previously starred. Removes the repository from the authenticated user's starred list. Returns { starred: false } on success. This is a no-op if the repository was not already starred (GitHub returns 204 either way), so the result is always { starred: false } on a 204 response. Docs: https://docs.github.com/en/rest/activity/starring#unstar-a-repository-for-the-authenticated-user

Inputs: repo (required), owner (required).

update_gistA

Update an existing gist. You can change the description and/or update, rename, or delete individual files. To update a file, supply its current filename as the key with new content or a new filename. To delete a file, supply its current filename as the key with a null value. Files not mentioned in the request are left unchanged. Docs: https://docs.github.com/en/rest/gists/gists#update-a-gist

Inputs: gist_id (required), files, description.

update_issueB

Update an existing issue in a GitHub repository. Docs: https://docs.github.com/en/rest/issues/issues#update-an-issue

Inputs: repo (required), owner (required), issue_number (required), body, +5 more.

update_pull_requestA

Update an existing pull request in a GitHub repository. Docs: https://docs.github.com/en/rest/pulls/pulls#update-a-pull-request

Inputs: repo (required), owner (required), pull_number (required), base, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    TDQS

    B3.4/5.0

    Scored across 108 tools

    Disambiguation5/5

    Each tool maps to a distinct GitHub REST endpoint and resource type; even dense areas like workflow runs and packages use precise noun phrases (e.g. list_workflow_run_jobs vs list_workflow_runs) that prevent confusion. The only near-overlaps (list_issues vs search_issues) are clearly disambiguated by repository-scoped vs global search semantics.

    Naming Consistency5/5

    All tool names follow a consistent lower_snake_case verb_noun pattern, with list_ for collection reads and get_ for single-item reads, and mutation verbs (create, update, delete, add, remove, merge, cancel, rerun) used predictably. Longer names like add_or_update_team_membership remain readable and aligned with the overall convention.

    Tool Count1/5

    At 108 tools, this is far beyond the 16-25 'heavy' range and falls squarely into the 'extreme mismatch (50+ tools)' category. The sheer number creates an overwhelming selection surface for agents, even though each tool is individually well-described.

    Completeness3/5

    Coverage is broad across repos, issues, PRs, workflows, gists, packages, advisories, and codespaces, with many full CRUD lifecycles present. However, there are notable missing operations: no create/update/delete repository, no releases, no alert state mutations (e.g. dismiss), and ProjectsV2 access is read-only.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables Git repository operations and GitHub PR workflows, allowing users to manage repositories, create branches, commit changes, and create pull requests through natural language.
      2
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that connects to the GitHub API to list and create issues, comment on issues, and list pull requests with diff summaries. It enables natural language management of GitHub repositories from MCP-compatible clients.
      MIT