PullNotifier

Microsoft Teams + GitHub Setup Guide

Install PullNotifier and start receiving smart GitHub PR notifications in Microsoft Teams in 5 minutes.

Skip the doc — install from AppSource

The fastest path is the Microsoft AppSource one-click install. The dashboard walks you through the rest.

Prerequisites

A Microsoft account with access to a Microsoft Teams workspace
Permission to add apps to Microsoft Teams (or a Teams admin who can approve PullNotifier)
A GitHub account with access to the organisations or repositories you want to monitor
~5 minutes

Setup Steps

Install PullNotifier from Microsoft AppSource

Open Microsoft Teams → Apps → search "PullNotifier" → Add. The app will request the minimum permissions required to post adaptive cards into your selected channels.

Install in TeamsMicrosoft Teams admins may need to approve the app first. If you do not see PullNotifier in the catalog, ask your Teams admin to enable third-party apps for your tenant.

When the PullNotifier app first loads in Teams, click "Sign in with GitHub" and authorise PullNotifier on the GitHub organisations or repositories you want to monitor.

Sign in with GitHubPullNotifier requests minimal scopes — read access to PR metadata, no code access. You can revoke at any time from your GitHub settings.

Pick the Microsoft Teams channel for notifications

In the dashboard, select the Team and channel where PR notifications should appear. You can map a single repo to a single channel or use advanced routing for multi-repo, multi-channel setups.

Connect channelNeed different repos to post to different channels? Use the per-channel routing options on the next screen — by repo, label, branch, or author.

Map GitHub usernames to Microsoft Teams handles

Open the three-dot menu (⋯) for your installation and choose "Manage Teams User Mapping". Enter each team member's GitHub username alongside their Microsoft Teams display name and email.

Map reviewersUser mapping enables accurate @mentions in adaptive card notifications. Bulk import from a CSV or pull from your Microsoft Entra (Azure AD) directory if your plan supports it.

Send a test notification

Open the three-dot menu (⋯) and click "Send sample notification". A test adaptive card should appear in your selected Microsoft Teams channel within a few seconds. You are live.

TestIf the card does not appear, check the troubleshooting section below or open a chat from the dashboard — the team typically responds within 1 hour during business hours.

What you get

Adaptive card notifications for PR opened, reviewed, merged, and closed events

Live card updates — the same card updates in place as PR status changes

Smart filtering: ignore drafts, dependency bumps, bot PRs

@mention support for PR authors and reviewers (requires user mapping)

Per-channel routing by repo, label, author, or branch

Daily PR digest delivered to your standup channel

Code review reminders nudging stale PRs back into motion

Works alongside Slack — connect both simultaneously

Troubleshooting

Card never appears in the channel: verify the bot was added to the channel (open the channel → Manage channel → Connectors / Apps).
@mentions show as plain text: open the user mapping screen and confirm the GitHub username matches and the Teams email/handle is correct.
Microsoft Teams admin blocks the install: the admin needs to approve PullNotifier in Microsoft Teams Admin Center under Manage apps.
Migrating from retired Office 365 Connectors: see the dedicated migration guide.

Setup FAQ

How do I install PullNotifier in Microsoft Teams?

Search for "PullNotifier" in the Microsoft Teams app catalog or Microsoft AppSource. Click Add, sign in with GitHub, then pick the Teams channel where notifications should appear.

Do I need a Teams admin to install PullNotifier?

You can install for personal use without admin approval. To install at the organisation level, a Microsoft Teams admin must approve PullNotifier in Microsoft Teams Admin Center.

Can I send GitHub notifications to multiple Microsoft Teams channels?

Yes. PullNotifier supports per-channel routing by repo, label, author, or branch. Map any GitHub trigger to any Microsoft Teams channel from the dashboard.

Does PullNotifier work with GitHub Enterprise Server?

Yes. PullNotifier supports both GitHub.com and GitHub Enterprise Server. Reach out for help with on-premise / isolated network configurations.

How do I migrate from the retired Office 365 Connectors?

Install PullNotifier from AppSource, sign in with GitHub, recreate your channel mappings in the dashboard, then disable the old connector. Total time: ~10 minutes per channel.