Command
nylas calendar find-time
Find available meeting times across multiple participants.
Written by Qasim Muhammad Staff SRE
What does nylas calendar find-time do?
The nylas calendar find-time command queries free/busy data for all --participants and returns time slots where everyone is available. Specify --duration in minutes and --days for the search window. Handles timezone differences automatically. Works with Google Calendar, Outlook, Exchange, Yahoo, iCloud, and IMAP providers.
Usage
nylas calendar find-time --participants EMAILS --duration MINUTES [--days N]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 |
| --participants | Comma-separated attendee emails |
| --duration | Meeting duration in minutes |
| --days | Number of days to search ahead (default 5) |
| --exclude-weekends | Exclude weekends from search |
| --timezones | Participant IANA timezones, aligned with --participants order |
| --working-end | Working hours end (HH:MM) |
| --working-start | Working hours start (HH:MM) |
Examples
The nylas calendar find-time command queries free/busy data for all --participants and returns time slots where everyone is available.
Find a 30-minute slot for two people
nylas calendar find-time --participants alice@example.com,bob@example.com --duration 30Search 10 days ahead for a 1-hour meeting
nylas calendar find-time --participants team-leads@example.com --duration 60 --days 10 --jsonExample output
Finding 1h slots for 2 participants over 7 days
WHEN SCORE NOTES
2026-07-01 14:00-15:00 UTC 94/100 All within working hours
2026-07-02 15:00-16:00 UTC 88/100 Mid-week, afternoon
2026-07-03 13:00-14:00 UTC 81/100 Good for both timezones
Top pick: 2026-07-01 14:00-15:00 UTCTroubleshooting
No available times found
Increase --days to widen the search window, or reduce --duration. Heavily booked calendars may have no common free slots in 5 days.
Participant availability not returned
Free/busy sharing must be enabled on the participant's calendar. Google Workspace shares free/busy by default; personal Gmail accounts may not.
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.
SavvyCal vs Nylas: Scheduling Compared
SavvyCal is a scheduling SaaS for end users. Nylas is the API and CLI for building scheduling into your product across Google, Microsoft, and iCloud calendars.
Run nylas calendar find-time --help for full help output.