Command
nylas timezone find-meeting
Find overlapping business hours across multiple timezones to schedule a meeting.
Written by Qasim Muhammad Staff SRE
What does nylas timezone find-meeting do?
The nylas timezone find-meeting command calculates available meeting windows when participants span multiple timezones. Pass two or more IANA zones and an optional duration, and it returns time slots where all participants fall within business hours (9 AM - 5 PM local). Saves the manual math when coordinating across US, EU, and APAC teams.
Usage
nylas timezone find-meeting --zones ZONE1,ZONE2 [--duration MINUTES]Flags
| Flag | Description |
|---|---|
| --json | Output as JSON |
| --no-color | Disable color output |
| --verbose(-v) | Enable verbose output |
| --config | Custom config file path |
| --help(-h) | Show help for the command |
| --limit | Limit results (most list commands) |
| --yes(-y) | Skip confirmations |
| --zones | Comma-separated IANA timezone identifiers |
| --duration | Meeting duration in minutes (default: 30) |
| --end-date | End date for search (YYYY-MM-DD, defaults to 7 days from start) |
| --end-hour | Working hours end (HH:MM) |
| --exclude-weekends | Exclude Saturday and Sunday |
| --start-date | Start date for search (YYYY-MM-DD, defaults to today) |
| --start-hour | Working hours start (HH:MM) |
Examples
The nylas timezone find-meeting command calculates available meeting windows when participants span multiple timezones.
Find meeting time for US and EU teams
nylas timezone find-meeting --zones America/New_York,Europe/LondonFind 60-minute slot across three timezones
nylas timezone find-meeting --zones America/Los_Angeles,America/New_York,Asia/Kolkata --duration 60Example output
Meeting Time Finder
Time Zones: America/New_York,Europe/London
Duration: 1h0m0s
Working Hours: 09:00 - 17:00
Date Range: 2026-06-21 to 2026-06-28
Best overlapping slots:
1. Mon Jun 22 13:00-14:00 UTC score 96 (NY 09:00, London 14:00)
2. Tue Jun 23 15:00-16:00 UTC score 90 (NY 11:00, London 16:00)Troubleshooting
No available slots found
When timezones are 10+ hours apart (e.g., US West Coast and East Asia), business hours may not overlap. Try reducing the duration or expanding to early/late hours.
Invalid zone in list
Each zone must be a valid IANA identifier separated by commas with no spaces. Example: America/New_York,Europe/Berlin
Recommended guides
Book meeting rooms from the CLI
Book meeting rooms from the CLI by listing calendar resources, using each room email as a calendar ID, and adding it as an event participant with less setup.
Google Calendar API Sync Tokens
Use Google Calendar API sync tokens for incremental event sync, handle the 410 GONE full-resync, and read calendars from the CLI.
Microsoft Graph calendarView Explained
Query the Microsoft Graph calendarView endpoint for events in a date range with recurrences expanded. Compare it to list events and read calendars from the CLI.
Microsoft Graph getSchedule Free/Busy
Call the Microsoft Graph getSchedule action to read free/busy for Outlook and Exchange calendars, then check availability across providers from the CLI.
Google Workspace CLI: Limits and Alternative
What gws covers, where its OAuth scope limits and pre-1.0 status bite, and when a multi-provider email and calendar CLI is the better fit.
Build an Appointment-Reminder Agent
Build an appointment-reminder agent with Nylas CLI: poll the calendar, send T-24h and T-1h reminder emails, and process reply confirmations to cut no-shows.
Run nylas timezone find-meeting --help for full help output.