by kria

An extensible plugin for TFS that sends notifications to Slack, HipChat and IRC

123 Stars 34 Forks Last release: over 3 years ago (v1.19.0) GNU General Public License v3.0 167 Commits 20 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


TfsNotificationRelay is an extensible plugin for Team Foundation Server that sends notifications to Slack, HipChat and IRC.

Build status


  • Slack
  • HipChat
  • IRC
  • SMTP
  • Microsoft Teams

Third-party Integrations


  • Notify multiple targets
  • Rule-based event filtering
  • Regex filtering on collection, project, repository, branch etc.
  • Configurable notification format
  • Notification links back to event in TFS web
  • Extensible to support other targets

Supported Events

  • XAML Build completion
  • vNext Build completion*
  • Build quality change
  • Work item update
  • Team project creation/deletion
  • Release creation*
  • Release deployment*
  • Git
    • Push and force-push
    • Pull request*
    • Comment on Pull request*
    • Comment on Commit*
    • Repository created
    • Repository renamed/deleted*
    • Branch created/deleted
    • Tag created/deleted (both lightweight and annotated)
    • Ref updated
  • TFVC
    • Checkin
    • Comment on changeset*

*TFS 2015 only


Slack screenshot

HipChat screenshot

TFS version support

Since the TFS API changes quite frequently, there are multiple editions of TfsNotificationRelay. Make sure you pick the correct one for your system.

  • TfsNotificationRelay for TFS 2013 (2013.2+)
  • TfsNotificationRelay for TFS 2015 (2015.2+)
  • TfsNotificationRelay for TFS 2017
  • TfsNotificationRelay for TFS 2017.1
  • TfsNotificationRelay for TFS 2017.2

Discontinued support (last builds available in v1.16.0):

  • TfsNotificationRelay for TFS 2015 RTM
  • TfsNotificationRelay for TFS 2015.1


Download from releases.

Installation & Configuration

See the wiki on how to install and configure TfsNotificationRelay.


Visual Studio 2015 is required since TfsNotificationRelay uses C# 6. All needed TFS dependecies are included, so you should be able to just clone and build.



Description Status

| TfsNotificationRelay for TFS 2017.2 | master status
| TfsNotificationRelay for TFS 2017.1 | tfs2017.1 status
| TfsNotificationRelay for TFS 2017 | tfs2017 status
| TfsNotificationRelay for TFS 2015.2+ | tfs2015 status
| TfsNotificationRelay for TFS 2013.2+ | tfs2013 status

Extending TfsNotificationRelay

TfsNotificationRelay can easily be extended to send notifications to other services. Notifier modules referenced in the configuration file will be loaded dynamically at run time, so TfsNotificationRelay doesn't have to be recompiled.

  1. Start a new class library project.
  2. Add a reference to DevCore.TfsNotificationRelay.dll.
  3. Create a class that implements the single method in
    . Take a look at the
    class for pointers.
  4. Build and drop in your new dll in the Plugins directory on the server.
  5. Add a new bot element in
    with the correct assembly-qualified type name and settings.


Copyright (C) 2014-2017 Kristian Adrup

TfsNotificationRelay is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. See included file COPYING for details.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.