Jenkins : MQTT Notification Plugin

Plugin Information

View MQTT Notification on the plugin site for more information.

A simple notifier that can publish build notifications to a topic on a MQTT broker.


MQTT is a machine-to-machine (M2M)/"Internet of Things" connectivity protocol. It was designed as an extremely lightweight publish/subscribe messaging transport. 

The following details are configurable per Jenkins job:

  • Broker hostname/port
  • Topic
  • Message

Both the topic and the message may also include certain dynamic variables. These include:

  • PROJECT_URL - The relative URL to the Jenkins project to which this job belongs (e.g. "job/my-build").
  • BUILD_RESULT - The result of the Job (e.g. SUCCESS, FAILURE, ABORTED, etc.)
  • BUILD_NUMBER - The build number
  • CULPRITS - Comma-separated list of build culprits

All other build variables and environment variables can also be used (JENKINS-41839).

The default topic when no value is specified is "jenkins/PROJECT_URL".

The default message when no value is specified is "BULD_RESULT".


1.7 (2017-06-27)

The MqttNotifier can now be used in a jenkins pipeline, too. (Thanks michaelknigge!)

1.6 (2017-03-15)

Fixed credentials problem introduced while refactoring for unit testing in previous release (JENKINS-42764)

1.5 (2017-03-06)

  • Fixed problem with variable substitution (JENKINS-41974)
  • Started using StrSubstitutor for variable substitution
  • Added a unit test, but it's not doing much yet. Need to improve this.

1.4.2 (2017-02-12)

  • Reverted language level to Java 7 following failed integration test

1.4.1 (2017-02-12)

  • Bumped pom parent version, triggered a few findbugs violations. Now fixed.

1.4 (2017-02-12)

  • MQTT Notification plugin should be able to publish build number, build parameters (JENKINS-41839)

1.3 (2016-01-09)

1.2.1 (2016-01-06)

  • No changes. Republished 1.2 as the release didn't quite make it public for some reason.

1.2 (2015-06-23)

1.1 (2013-08-15)

  • Modified DefaultFilePersistence to use

1.0 (2013-08-12)

  • Initial release