MQTT MCP Server

Name: MQTT MCP Server
Author: io.github.nagarjunr

io.github.nagarjunr/mqtt

Repository Registry

What is the MQTT MCP server?

MCP server for MQTT 5.0 brokers (publish, subscribe, topic discovery).

How to install MQTT

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

MQTT_HOST
required
Broker hostname or IP
MQTT_PORT
Broker port, default 1883 (or 8883 for TLS)
MQTT_USERNAME
Broker username
MQTT_PASSWORD
secret
Broker password
MQTT_USE_TLS
true/false, default false

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mqtt": {
      "command": "uvx",
      "args": [
        "mqtt5-mcp-server"
      ],
      "env": {
        "MQTT_HOST": "<YOUR_MQTT_HOST>",
        "MQTT_PORT": "<YOUR_MQTT_PORT>",
        "MQTT_USERNAME": "<YOUR_MQTT_USERNAME>",
        "MQTT_PASSWORD": "<YOUR_MQTT_PASSWORD>",
        "MQTT_USE_TLS": "<YOUR_MQTT_USE_TLS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mqtt": {
      "command": "uvx",
      "args": [
        "mqtt5-mcp-server"
      ],
      "env": {
        "MQTT_HOST": "<YOUR_MQTT_HOST>",
        "MQTT_PORT": "<YOUR_MQTT_PORT>",
        "MQTT_USERNAME": "<YOUR_MQTT_USERNAME>",
        "MQTT_PASSWORD": "<YOUR_MQTT_PASSWORD>",
        "MQTT_USE_TLS": "<YOUR_MQTT_USE_TLS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mqtt": {
      "command": "uvx",
      "args": [
        "mqtt5-mcp-server"
      ],
      "env": {
        "MQTT_HOST": "<YOUR_MQTT_HOST>",
        "MQTT_PORT": "<YOUR_MQTT_PORT>",
        "MQTT_USERNAME": "<YOUR_MQTT_USERNAME>",
        "MQTT_PASSWORD": "<YOUR_MQTT_PASSWORD>",
        "MQTT_USE_TLS": "<YOUR_MQTT_USE_TLS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mqtt": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mqtt5-mcp-server"
      ],
      "env": {
        "MQTT_HOST": "<YOUR_MQTT_HOST>",
        "MQTT_PORT": "<YOUR_MQTT_PORT>",
        "MQTT_USERNAME": "<YOUR_MQTT_USERNAME>",
        "MQTT_PASSWORD": "<YOUR_MQTT_PASSWORD>",
        "MQTT_USE_TLS": "<YOUR_MQTT_USE_TLS>"
      }
    }
  }
}

Claude Code

claude mcp add mqtt --env MQTT_HOST=<YOUR_MQTT_HOST> --env MQTT_PORT=<YOUR_MQTT_PORT> --env MQTT_USERNAME=<YOUR_MQTT_USERNAME> --env MQTT_PASSWORD=<YOUR_MQTT_PASSWORD> --env MQTT_USE_TLS=<YOUR_MQTT_USE_TLS> -- uvx mqtt5-mcp-server