MQTT MCP Server

by nagarjunrio.github.nagarjunr/mqttv0.1.0

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

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install MQTT MCP server

claude mcp add mqtt -e MQTT_HOST='<mqtt-host>' -e MQTT_PASSWORD='<mqtt-password>' -- uvx mqtt5-mcp-server

{
  "mcpServers": {
    "mqtt": {
      "command": "uvx",
      "args": [
        "mqtt5-mcp-server"
      ],
      "env": {
        "MQTT_HOST": "<mqtt-host>",
        "MQTT_PASSWORD": "<mqtt-password>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "mqtt": {
      "command": "uvx",
      "args": [
        "mqtt5-mcp-server"
      ],
      "env": {
        "MQTT_HOST": "<mqtt-host>",
        "MQTT_PASSWORD": "<mqtt-password>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "mqtt": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mqtt5-mcp-server"
      ],
      "env": {
        "MQTT_HOST": "<mqtt-host>",
        "MQTT_PASSWORD": "<mqtt-password>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "mqtt": {
      "command": "uvx",
      "args": [
        "mqtt5-mcp-server"
      ],
      "env": {
        "MQTT_HOST": "<mqtt-host>",
        "MQTT_PASSWORD": "<mqtt-password>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MQTT_HOST	yes	—	Broker hostname or IP
MQTT_PORT	—	—	Broker port, default 1883 (or 8883 for TLS)
MQTT_USERNAME	—	—	Broker username
MQTT_PASSWORD	—	yes	Broker password
MQTT_USE_TLS	—	—	true/false, default false

Freshness

Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-04 · 2mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-07-24 · 3mo ago · official registry · v0.1.0

FAQ

›How do I install the MQTT MCP server in Claude Code?

Run: claude mcp add mqtt -e MQTT_HOST='<mqtt-host>' -e MQTT_PASSWORD='<mqtt-password>' -- uvx mqtt5-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does MQTT require an API key?

Yes. It expects MQTT_HOST, MQTT_PASSWORD, of which 1 is a secret.

›Can I use MQTT as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is MQTT in the official MCP registry?

Yes, as io.github.nagarjunr/mqtt.