diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a871b41
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+# nymea-mqtt
+Nymea MQTT broker
+
+The nymea MQTT broker consists of a library containing a MqttClient and a MqttServer implementation.
+It can be used standalone or integrated in other applications.