Skip to main content
The GitHub MCP Server is GitHub’s official Model Context Protocol server, enabling AI agents within Caylex to interact directly with GitHub repositories, issues, pull requests, branches, releases, and more. It provides a comprehensive set of tools for automating software development workflows — from creating and merging pull requests to searching code, managing issue tracking, and running secret scanning. Agents can read and write file contents, manage branches, fork or create repositories, and even request Copilot-powered code reviews, all without leaving the Caylex ecosystem. Certain advanced tools — such as those interacting with GitHub Copilot Coding Agent features like assign_copilot_to_issue or create_pull_request_with_copilot — require a paid GitHub Copilot license on the authenticated account. This server is ideal for teams looking to automate code review workflows, triage issues, synchronize repository tasks, and enhance collaborative development through AI agents.
Prerequisites:
  • A valid GitHub account is required; a paid GitHub Copilot license is additionally required for Copilot-specific tools.
  • A GitHub Personal Access Token (PAT) with the necessary permission scopes, or OAuth authentication, must be configured when adding the server to your Caylex project.
  • If operating within a GitHub organization or enterprise, ensure the organization’s MCP policy is enabled by an admin before use.
Important API details:
  • Tools that interact with GitHub Copilot Coding Agent features (e.g., assign_copilot_to_issue, create_pull_request_with_copilot, request_copilot_review) require a paid GitHub Copilot license.
  • Authentication via a Personal Access Token (PAT) requires the token to have the appropriate scopes for each action — for example, repo scope for repository access and write operations.
  • If authenticating as a member of a GitHub organization or enterprise with Copilot Business or Copilot Enterprise, the organization’s ‘MCP servers in Copilot’ policy must be enabled at the org/enterprise level.
  • All tools inherit the same access requirements as their corresponding GitHub features — if a GitHub feature requires elevated permissions or a paid plan, the equivalent MCP tool will too.

Server Details

PropertyValue
TransportStreamable HTTP
HostingRemote (externally hosted)
CategoriesVersion Control, Development & DevOps

Authentication

This server supports the following authentication method:

OAuth

Scopes: repo, user, gist, notifications, project, workflow, codespaceRetry During the server onboarding flow, you will be prompted to complete the OAuth flow to grant access. See the Github Authentication guide for step-by-step credential configuration.

Getting Started

1

Add the server

Navigate to the Server Library and click on the New Server button. Find Github in the Caylex Catalog.
2

Server Onboarding flow

Go through the server onboarding flow.
3

Use in a project

Add the server to a project by configuring project connections. Its tools are now available to any agents connected to that project.

Available Tools

This server provides 44 tools:

Repository Management

Create a new GitHub repository in your account or specified organization
Fork a GitHub repository to your account or specified organization
Get the contents of a file or directory from a GitHub repository
Create or update a single file in a GitHub repository. If updating, you should provide the SHA of the file you want to update. Use this tool to create or update a file in a GitHub repository remotely; do not use it for local file operations.In order to obtain the SHA of original file version before updating, use the following git command: git rev-parse <branch>:<path to file>SHA MUST be provided for existing file updates.
Delete a file from a GitHub repository
Push multiple files to a GitHub repository in a single commit
List branches in a GitHub repository
Create a new branch in a GitHub repository
Get list of commits of a branch in a GitHub repository. Returns at least 30 results per page by default, but can return more if specified using the perPage parameter (up to 100).
Get details for a commit from a GitHub repository
Find GitHub repositories by name, description, readme, topics, or other metadata. Perfect for discovering projects, finding examples, or locating specific repositories across GitHub.
Fast and precise code search across ALL GitHub repositories using GitHub’s native search engine. Best for finding exact symbols, functions, classes, or specific code patterns.

Issue Management

List issues in a GitHub repository. For pagination, use the ‘endCursor’ from the previous response’s ‘pageInfo’ in the ‘after’ parameter.
Get information about a specific issue in a GitHub repository.
Create a new or update an existing issue in a GitHub repository.
Add a comment to a specific issue in a GitHub repository. Use this tool to add comments to pull requests as well (in this case pass pull request number as issue_number), but only if user is not asking specifically to add review comments.
Search for issues in GitHub repositories using issues search syntax already scoped to is:issue
List supported issue types for repository owner (organization).
Add a sub-issue to a parent issue in a GitHub repository.
Assign Copilot to a specific issue in a GitHub repository.This tool can help with the following outcomes:
  • a Pull Request created with source code changes to resolve the issue
More information can be found at:
Get a specific label from a repository.

Pull Request Management

List pull requests in a GitHub repository. If the user specifies an author, then DO NOT use this tool and use the search_pull_requests tool instead.
Get information on a specific pull request in GitHub repository.
Create a new pull request in a GitHub repository.
Update an existing pull request in a GitHub repository.
Update the branch of a pull request with the latest changes from the base branch.
Merge a pull request in a GitHub repository.
Search for pull requests in GitHub repositories using issues search syntax already scoped to is:pr
Add a reply to an existing pull request comment. This creates a new comment that is linked as a reply to the specified comment.
Create and/or submit, delete review of a pull request.Available methods:
  • create: Create a new review of a pull request. If “event” parameter is provided, the review is submitted. If “event” is omitted, a pending review is created.
  • submit_pending: Submit an existing pending review of a pull request. This requires that a pending review exists for the current user on the specified pull request. The “body” and “event” parameters are used when submitting the review.
  • delete_pending: Delete an existing pending review of a pull request. This requires that a pending review exists for the current user on the specified pull request.
Add review comment to the requester’s latest pending pull request review. A pending review needs to already exist to call this (check with the user if not sure).
Delegate a task to GitHub Copilot coding agent to perform in the background. The agent will create a pull request with the implementation. You should use this tool if the user asks to create a pull request to perform a specific task, or if the user asks Copilot to do something.
Request a GitHub Copilot code review for a pull request. Use this for automated feedback on pull requests, usually before requesting a human reviewer.

Releases & Tags

List releases in a GitHub repository
Get the latest release in a GitHub repository
Get a specific release by its tag name in a GitHub repository
List git tags in a GitHub repository
Get details about a specific git tag in a GitHub repository

Teams & Users

Get details of the authenticated GitHub user. Use this when a request is about the user’s own profile for GitHub. Or when information is missing to build other tool calls.
Get details of the teams the user is a member of. Limited to organizations accessible with current credentials
Get member usernames of a specific team in an organization. Limited to organizations accessible with current credentials
Find GitHub users by username, real name, or other profile information. Useful for locating developers, contributors, or team members.

Copilot & Security

Get the status of a GitHub Copilot coding agent job. Use this to check if a previously submitted task has completed and to get the pull request URL once it’s created. Provide the job ID (from create_pull_request_with_copilot) or pull request number (from assign_copilot_to_issue), or any pull request you want agent sessions for.
Scan files, content, or recent changes for secrets such as API keys, passwords, tokens, and credentials.This tool is intended for targeted scans of specific files, snippets, or diffs provided directly as content. It accepts file contents or diffs and returns detected secrets with their locations and related secret scanning metadata. Content must not be empty. For full repository scanning, other mechanisms are available.Caveats:
  • Only files within the codebase should be scanned. Files outside of the codebase should not be sent.
  • Files listed in .gitignore should be skipped.
https://d338mlbnszozgc.cloudfront.net/logos/linear.svg

Linear

https://d338mlbnszozgc.cloudfront.net/logos/atlassian.svg

Atlassian

https://d338mlbnszozgc.cloudfront.net/logos/sentry.svg

Sentry

References

https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/use-the-github-mcp-server

https://github.com/github/github-mcp-server