Skip to content
MQTT Client native module for react-native
Objective-C Java Shell Swift C JavaScript
Branch: master
Clone or download
Latest commit ceb238c May 20, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
android remove native clients so that there will not be any clients on the na… Feb 14, 2017
ios/RCTMqtt remove native clients so that there will not be any clients on the na… Feb 14, 2017
.gitignore release beta 1 Feb 8, 2016 update prefer paho May 26, 2016
package.json correct usage Feb 22, 2016


Please use paho.mqtt.javascript for your application, this repository not use for production


react-native mqtt client module

MQTT Features (inherit from native MQTT framework)


This library in progress developing, api may change, SSL/TLS non verify

Getting started

Manual install


  • npm install react-native-mqtt@latest --save
  • In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
  • Go to node_modulesreact-native-mqtt and add RCTMqtt.xcodeproj
  • In XCode, in the project navigator, select your project. Add libRCTmqtt.a to your project's Build PhasesLink Binary With Libraries
  • Click RCTMqtt.xcodeproj in the project navigator and go the Build Settings tab. Make sure 'All' is toggled on (instead of 'Basic'). In the Search Paths section, look for Header Search Paths and make sure it contains both $(SRCROOT)/../../react-native/React - mark as recursive.
  • Run your project (Cmd+R)


  • npm install react-native-mqtt@latest --save
  • Modify the ReactInstanceManager.builder() calls chain in android/app/main/java/.../ to include:
import com.tuanpm.RCTMqtt.*; // import

.addPackage(new RCTMqttPackage()) //for older version

new RCTMqttPackage()           // for newest version of react-native
  • Append the following lines to android/settings.gradle before include ':app':
include ':react-native-mqtt'
project(':react-native-mqtt').projectDir = new File(rootProject.projectDir,  '../node_modules/react-native-mqtt/android')

  • Insert the following lines inside the dependencies block in android/app/build.gradle, don't missing apply plugin:'java' on top:
compile project(':react-native-mqtt')


dependencies {
  compile project(':react-native-mqtt')


var mqtt    = require('react-native-mqtt');

/* create mqtt client */
  uri: 'mqtt://', 
  clientId: 'your_client_id'
}).then(function(client) {

  client.on('closed', function() {
  client.on('error', function(msg) {
    console.log('mqtt.event.error', msg);

  client.on('message', function(msg) {
    console.log('mqtt.event.message', msg);

  client.on('connect', function() {
    client.subscribe('/data', 0);
    client.publish('/data', "test", 0, false);



  • mqtt.createClient(options) create new client instance with options, async operation

    • uri: protocol://host:port, protocol is [mqtt | mqtts]
    • host: ipaddress or host name (override by uri if set)
    • port: port number (override by uri if set)
    • tls: true/false (override by uri if set to mqtts or wss)
    • user: string username
    • pass: string password
    • auth: true/false - override = true if user or pass exist
    • clientId: string client id
    • keepalive
  • client

    • on(event, callback): add event listener for
      • event: connect - client connected
      • event: closed - client disconnected
      • event: error - error
      • event: message - message object
    • connect: begin connection
    • disconnect: disconnect
    • subscribe(topic, qos)
    • publish(topic, payload, qos, retain)
  • message

    • retain: boolean false
    • qos: number 2
    • data: string "test message"
    • topic: string "/data"


  • todo


You can’t perform that action at this time.