# Integrating GitHub with Teams

Set up the GitHub integration with Teams to improve collaboration and streamline workflows.

## About the GitHub integration for Teams

The GitHub integration for Microsoft Teams gives you and your teams visibility into your GitHub projects directly in Teams channels. You can triage issues, collaborate on pull requests, and keep track of changes without leaving Teams.

With the GitHub integration for Teams, you can:

* Get **GitHub notifications** in Teams channels.

* Use **commands** to take actions on GitHub.

* See **previews** when sharing links to GitHub resources.

* Initiate a Copilot cloud agent session from Teams, using the context of a Teams thread.

When you grant the GitHub app access to your Teams workspace, you are granting it certain permissions. The permissions provided are necessary for the app to function correctly and provide the features you expect. See [Permissions for GitHub in Teams](/en/integrations/reference/teams-permissions).

## Prerequisites

To use the GitHub integration for Teams, you need:

* A GitHub account.
* A Teams workspace where you have permission to install apps.

## Installing the GitHub integration for Teams in a single workspace

1. Go to the [GitHub integration for Teams](https://teams.microsoft.com/l/app/ca9e26b7-dce5-44a0-b2b7-a70a3d65ce25) listing in the Teams app store.
2. Click **Add**.
3. Follow the prompts to sign in to Teams and approve access.
4. In Teams, run `@GitHub Notifications signin` and follow the prompts to connect your GitHub account.

## Further reading

* [Using GitHub in Teams](/en/integrations/how-tos/teams/use-github-in-teams) - Learn how to use the GitHub integration for Teams.
* [Customizing notifications for GitHub in Teams](/en/integrations/how-tos/teams/customize-notifications) - Learn how to customize your GitHub notifications in Teams.