diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3410396
--- /dev/null
+++ b/README.md
@@ -0,0 +1,28 @@
+# HTML Events to Google Calendar Links
+
+This script extracts event data from an HTML table and generates Google Calendar "Add to Calendar" links, including support for guest emails.
+
+## Usage
+
+```bash
+python generate_links.py <url> -g guest1@example.com -g guest2@example.com
+```
+
+- `<url>`: The URL of the page containing the event table.
+- `-g`: (Optional) Add one or more guest email addresses.
+
+## Example
+
+```bash
+python generate_links.py https://newsletters.naavi.com/i/JKdOO0M/issue-16/page/5 -g joanna.gilligan@gmail.com
+```
+
+## Output
+
+- Generates an `calendar_links.html` file with clickable Google Calendar links.
+
+## Requirements
+
+- Python 3.x
+- `requests`
+- `beautifulsoup4`