diff --git a/README.md b/README.md index b2e87ca..f007b93 100644 --- a/README.md +++ b/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 +