GitHub Integration

The GitHub integration provides access to manage GitHub repos, issues, and pull requests through the Integrate MCP server.

Installation

The GitHub integration is included with the SDK:

import { githubIntegration } from "integrate-sdk/server";

Setup

1. Create a GitHub OAuth App

1. Go to GitHub Developer Settings
2. Create a new OAuth application
3. Configure your redirect URI
4. Note your Client ID and Client Secret

2. Configure the Integration on Your Server

Add the GitHub integration to your server configuration. The integration automatically reads GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET from your environment variables:

import { createMCPServer, githubIntegration } from "integrate-sdk/server";

export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    githubIntegration({
    }),
  ],
});

You can override the environment variables by passing explicit values:

githubIntegration({
  clientId: process.env.CUSTOM_GITHUB_ID,
  clientSecret: process.env.CUSTOM_GITHUB_SECRET,
});

3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

import { client } from "integrate-sdk";

await client.authorize("github");
const result = await client.github.createIssue({
  owner: "value",
});

console.log(result);

If you're using a custom client, add the integration to the integrations array:

import { createMCPClient, githubIntegration } from "integrate-sdk";

const customClient = createMCPClient({
  integrations: [githubIntegration()],
});

Configuration Options

Tools

github_create_issue

Create a new issue in a repository

github_list_issues

List issues in a repository

github_get_issue

Get a specific issue

github_update_issue

Update an existing issue

github_close_issue

Close an issue

github_create_pull_request

Create a pull request

github_list_pull_requests

List pull requests in a repository

github_get_pull_request

Get a specific pull request

github_merge_pull_request

Merge a pull request

github_list_repos

List repositories (for a user or organization)

github_list_own_repos

List repositories for the authenticated user

github_get_repo

Get a specific repository

github_create_repo

Create a new repository

github_list_branches

List branches in a repository

github_create_branch

Create a new branch

github_get_authenticated_user

Get information about the authenticated user

No parameters.

github_get_user

Get information about a user

github_list_commits

List commits in a repository

github_get_commit

Get a specific commit

github_list_issue_comments

List comments on an issue

github_add_issue_comment

Add a comment to an issue

github_update_issue_comment

Update an issue comment

github_delete_issue_comment

Delete an issue comment

github_list_pr_files

List pr files

No parameters.

github_list_pr_commits

List pr commits

No parameters.

github_list_pr_reviews

List pr reviews

No parameters.

github_create_pr_review

Create pr review

No parameters.

github_list_pr_review_comments

List pr review comments

No parameters.

github_get_file_contents

Get the contents of a file or directory in a repository

github_create_or_update_file

Create or update a file in a repository

github_delete_file

Delete a file from a repository

github_list_releases

List releases in a repository

github_get_release

Get a specific release

github_get_latest_release

Get the latest release for a repository

github_create_release

Create a release

github_list_labels

List labels for a repository

github_create_label

Create a label in a repository

github_add_issue_labels

Add labels to an issue

github_list_collaborators

List collaborators for a repository

github_fork_repo

Fork a repository

github_search_repos

Search repositories

github_search_issues

Search issues and pull requests

github_search_code

Search code

github_list_workflows

List workflows in a repository

github_list_workflow_runs

List workflow runs for a repository or workflow

github_trigger_workflow

Trigger a workflow dispatch event

github_list_milestones

List milestones for a repository

github_create_milestone

Create a milestone

Notes

• Category: Engineering
• Authentication mode: OAuth