Integrating GitHub with Teams

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

In this article

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 work with Copilot cloud agent to research, plan and triage in conversations, create artifacts such as issues and pull requests, start and steer agent sessions, 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 and steer Copilot cloud agent sessions in a conversation. Teammates can collaborate with each other and the agent, add context, correct assumptions, continue an agent task, and review the resulting plan, issues, pull requests and other artifacts.

    Note

    • This feature is currently in public preview and subject to change.

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.

Prerequisites

To use the GitHub integration for Teams, you need:

  • A GitHub account.

  • A Teams workspace where you have permission to install apps.

  • You must have Microsoft Public Developer Preview enabled for your Microsoft Teams client, see Public developer preview for Teams in the Microsoft Learn documentation.

  • To use Copilot cloud agent, you must have cloud sandboxes enabled for your Copilot plan. See Cloud sandboxing for GitHub Copilot.

    Note

    Cloud sandbox policies share the same configuration as Copilot cloud agent policies. Members of an organization or enterprise, including an enterprise with managed users may need their owner to enable cloud sandboxes and Copilot cloud agent before they can use Copilot in Teams. See Enabling or disabling cloud sandboxes for your organization or enterprise.

Installing the GitHub integration for Teams in a single workspace

  1. Go to the GitHub integration for Teams listing in the Teams app store.
  2. Click Add.
  3. Follow the prompts to sign in to Teams and approve access.
  4. In a Teams message or channel, @mention the app by typing @GitHub and follow the prompts to connect your GitHub account.
  5. To see what else you can do, in the thread, @mention the app by typing @GitHub help.

Installing the Teams app for GitHub Enterprise Cloud with data residency

If you use GitHub Enterprise Cloud with data residency on GHE.com, install the data-residency app from AppSource and sign in with your GitHub Enterprise Cloud account when prompted.

Further reading