Configuration

Environment variables

Variable	Description	Required
`GOOGLE_CLIENT_ID`	Google OAuth 2.0 client ID	For Google Calendar
`GOOGLE_CLIENT_SECRET`	Google OAuth 2.0 client secret	For Google Calendar
`OUTLOOK_CLIENT_ID`	Microsoft OAuth 2.0 client ID	For Outlook
`OUTLOOK_CLIENT_SECRET`	Microsoft OAuth 2.0 client secret	For Outlook
`CALDAV_URL`	CalDAV server URL	For CalDAV
`CALDAV_USERNAME`	CalDAV username	For CalDAV
`CALDAV_PASSWORD`	CalDAV password	For CalDAV

Variable	Description	Required
`DATABASE_URL`	PostgreSQL connection string	Enables Platform Mode
`REDIS_URLS`	Comma-separated Redis URLs	Optional (distributed locking)
`API_BASE_URL`	Platform API URL	For Platform-only tools
`API_KEY`	Platform API key	For authenticated access

Variable	Description	Default
`TRANSPORT`	MCP transport: `stdio` or `http`	`stdio`
`PORT`	HTTP server port (when `TRANSPORT=http`)	`3000`
`LOG_LEVEL`	Logging level: `error`, `warn`, `info`, `debug`	`info`

Control when bookings are allowed:

Variable	Description	Default
`MAX_ADVANCE_DAYS`	Maximum days in advance a booking can be made	`90`
`MIN_NOTICE_HOURS`	Minimum hours notice before a booking	`1`

All data tools return TOON by default. Override per-call with format: "json" or set globally:

Variable	Description	Default
`DEFAULT_FORMAT`	Default output format: `toon` or `json`	`toon`

Temporal Cortex auto-detects its operating mode at startup:

Local Mode (default): No DATABASE_URL set. All 15 core tools available. In-process locking. Local credential storage.
Platform Mode: DATABASE_URL set. All 18 tools available. Distributed Redlock (if REDIS_URLS set). Managed OAuth. Usage metering.

No configuration flag needed — the presence of DATABASE_URL determines the mode.