diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9309d6a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# icomical - KOMIDA to iCal
+
+Fetches upcoming menu (14 days) from Komida JSON API and converts it to `.ical` format, to be imported into e.g., Google Calendar.
+
+Hardcoded features:
+ - fetches up to 14 days in the future
+ - only creates calendar items for:
+    - daily menu
+    - "street food"
+    - soup
+ - menu items are in Dutch
+ - calendar items match the opening hours of Komida (11:30 - 13:45)
+
+The output of this program (updated daily) is available as-a-service at:
+
+https://deemz.org/public/komida.ical
+