Document get_current_time tool and TIMEZONE env variable in README

README.md

@@ -197,6 +197,14 @@ Optional email:
     ]
 - SCHEDULED_SEND_INTERVAL: Seconds between checks for scheduled emails (default: 10).
 
+Time and timezone:
+
+- TIMEZONE:
+  - IANA timezone used by get_current_time (e.g. "America/New_York", "Europe/London", "UTC").
+  - Default: "UTC".
+  - Example:
+      -e TIMEZONE="America/New_York"
+
 HTML, signature, and LLM identity:
 
 - Emails (send_email, reply_to_message, forward_message, schedule_send) default to HTML (html=true) unless explicitly set to false.
@@ -256,6 +264,7 @@ All tools are exposed via MCP (Streamable HTTP) at POST /mcp.
 General:
 
 - list_accounts
+- get_current_time
 
 Email (listing, reading, and triage):
 
@@ -396,3 +405,26 @@ Example (docker run):
 
 If these are not set:
 - The summarize_email tool will still work, but will fall back to returning the first N words of the email instead of using an external model.
+
+## get_current_time tool
+
+Provides the LLM with a reliable reference time so it can interpret relative terms like "today", "yesterday", or "last week".
+
+- Name: get_current_time
+- Input: none
+- Output:
+  - iso: current time in ISO 8601 format (e.g. 2025-06-28T10:15:00+01:00)
+  - timezone: configured timezone (from TIMEZONE env variable)
+
+Usage:
+- Call get_current_time when:
+  - Filtering or sorting by relative dates
+  - Checking if an email is recent or overdue
+- The tool uses the TIMEZONE environment variable.
+- Example Docker run:
+
+  docker run -d \
+    -p 8000:8000 \
+    -e TIMEZONE="America/New_York" \
+    mcp-email-server
+