DEV Community

Qasim Muhammad
Qasim Muhammad

Posted on

nylas calendar availability check: Developer Reference with Examples

Calendar management belongs in the terminal too. nylas calendar availability check works with Google Calendar, Outlook, and Exchange.

The nylas calendar availability check command queries free/busy data for one or more participants within a time window. Pass --start and --end as ISO 8601 timestamps and --participants as a comma-separated list of email addresses.

Quick Start

brew install nylas/nylas-cli/nylas
nylas init
nylas calendar availability check
Enter fullscreen mode Exit fullscreen mode

Syntax

nylas calendar availability check --start START --end END --participants EMAILS
Enter fullscreen mode Exit fullscreen mode

How It Works

Calendar APIs are notoriously inconsistent across providers. Google Calendar uses RFC 5545 recurrence rules, Outlook uses its own format, and Exchange has yet another. The Nylas CLI normalizes all of this behind a consistent interface.

Key Flags

Run nylas calendar availability check --help to see all available flags. Add --json for machine-readable output — useful when piping into jq or feeding data to scripts.

nylas calendar availability check --help
Enter fullscreen mode Exit fullscreen mode

Examples

Check if a slot is free for two people:

nylas calendar availability check --start 2026-03-27T10:00:00Z --end 2026-03-27T11:00:00Z --participants alice@example.com,bob@example.com
Enter fullscreen mode Exit fullscreen mode

Find free windows in a day as JSON:

nylas calendar availability check --start 2026-03-27T08:00:00Z --end 2026-03-27T18:00:00Z --participants team@example.com --json
Enter fullscreen mode Exit fullscreen mode

Related Commands


Full docs: nylas calendar availability check reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylasother install methods

Top comments (0)