Skip to main content
Back to plugins
@capgo/capacitor-mqtt
Tutorial
@capgo/capacitor-mqtt

MQTT

MQTT support for real-time messaging across iOS, Android, and Web.

Guide

Tutorial on MQTT

Using @capgo/capacitor-mqtt

Capacitor plugin for MQTT connectivity on Android and iOS.

Install

bun add @capgo/capacitor-mqtt
bunx cap sync

What This Plugin Exposes

  • connect
  • disconnect
  • subscribe
  • publish

Example Usage

connect

See the upstream definitions for the current contract.

import { MqttBridge } from '@capgo/capacitor-mqtt';

await MqttBridge.connect({} as {
    serverURI: string;
    port: number;
    clientId: string;
    username: string;
    password: string;
    setCleanSession: boolean;
    connectionTimeout: number;
    keepAliveInterval: number;
    setAutomaticReconnect: boolean;
    setLastWill?: {
      willTopic: string;
      willPayload: string;
      willQoS: number;
      setRetained: boolean;
    };
  });

disconnect

See the upstream definitions for the current contract.

import { MqttBridge } from '@capgo/capacitor-mqtt';

await MqttBridge.disconnect();

subscribe

See the upstream definitions for the current contract.

import { MqttBridge } from '@capgo/capacitor-mqtt';

await MqttBridge.subscribe({} as { topic: string; qos: number });

publish

See the upstream definitions for the current contract.

import { MqttBridge } from '@capgo/capacitor-mqtt';

await MqttBridge.publish({} as { topic: string; payload: string; qos: number; retained: boolean });

Full Reference

Keep going from Using @capgo/capacitor-mqtt

If you are using Using @capgo/capacitor-mqtt to plan native plugin work, connect it with @capgo/capacitor-mqtt for the implementation detail in @capgo/capacitor-mqtt, Getting Started for the implementation detail in Getting Started, Capgo Plugin Directory for the product workflow in Capgo Plugin Directory, Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, and Adding or Updating Plugins for the implementation detail in Adding or Updating Plugins.