A AgendaDeck

AgendaDeck support

Last updated: 27 May 2026

Need a human? Email support@agendadeck.com. We reply within two business days (Mon–Fri, 9–17 UTC). Please include your operating system, Stream Deck app version, and AgendaDeck version (visible at the bottom of the Property Inspector).
Contents

Installing AgendaDeck

  1. Make sure the Stream Deck app is version 6.5 or newer. Older versions don't support the SDK features AgendaDeck uses.
  2. Buy AgendaDeck from the Elgato Marketplace. The plugin is delivered as a .streamDeckPlugin file.
  3. Double-click the downloaded file. The Stream Deck app will prompt you to install — click Install.
  4. Open the Stream Deck app. Under the Actions panel on the right, you'll see four new AgendaDeck actions: Countdown, Agenda, Join, and Timeline Slot.
  5. Drag any AgendaDeck action onto a key. The Property Inspector will open and ask you to connect a calendar account.

Connect Google Calendar

  1. With any AgendaDeck action selected, click Connect account in the Property Inspector and choose Google.
  2. Your default browser opens Google's sign-in page. Choose the account whose calendar you want to display.
  3. On the consent screen, you'll see AgendaDeck request the read-only calendar scope. Click Allow.
  4. Google redirects to a localhost confirmation page handled by the plugin. You can close the browser tab — the Property Inspector should now show your account email.

Note: AgendaDeck only ever requests read-only calendar scope. It cannot create, modify, or delete events.

Connect Microsoft 365 / Outlook

  1. In the Property Inspector, click Connect account and choose Microsoft.
  2. Sign in with either a personal Microsoft account (outlook.com, hotmail.com, live.com) or a work / school Microsoft 365 account.
  3. On the consent screen, accept Calendars.Read and offline_access. If your organization requires admin approval, the screen will say so — forward the link to your IT admin.
  4. Once consent is granted, the Property Inspector will show your Microsoft account.

If you see "Need admin approval", your tenant requires admin consent for third-party apps. Send your admin to https://login.microsoftonline.com/<your-tenant>/adminconsent with the AgendaDeck app ID shown in the error.

Connect iCloud Calendar

Apple does not offer OAuth for iCloud Calendar, so AgendaDeck uses CalDAV with an app-specific password. Your real Apple ID password never leaves Apple.

  1. Sign in to appleid.apple.com with your Apple ID.
  2. Under Sign-In and Security, click App-Specific Passwords → Generate an app-specific password.
  3. Label it AgendaDeck (or anything you'll recognize). Copy the 16-character password Apple displays — you can't retrieve it again later.
  4. In the AgendaDeck Property Inspector, choose iCloud, enter your Apple ID email, and paste the app-specific password.
  5. Click Connect. The plugin will discover your calendars over CalDAV and confirm the connection.

The app-specific password is stored locally in the Stream Deck plugin settings store and is never transmitted to AgendaDeck servers. To revoke it later, sign in to appleid.apple.com and remove it from the app-specific password list.

Configure the four actions

Countdown

Shows the time until your next event. Configure: which calendar(s) to watch, whether to ignore all-day events, and the warning threshold (the key turns amber when the meeting is about to start).

Agenda

Lists the next N events (default 3) on a single key. Press the key to scroll to the following window. Long-press to refresh.

Join

One-press launch of the conferencing link from your current event. Supports any URL the organizer attached — Zoom, Google Meet, Microsoft Teams, Webex, custom URLs. If multiple links are attached, the action prefers the one in the conferencing field.

Timeline Slot

Place several Timeline Slot keys next to each other to render a visual timeline of your day across your deck. Each slot represents a window (default 30 min) and shows free, busy, or "starting soon".

Troubleshooting

"Reauthorization required" / the key shows a key icon

OAuth refresh tokens can expire if you change your password, your organization revokes consent, or the token has been idle for a long time. Open the Property Inspector and click Reconnect account. The flow is identical to the original connection.

The key shows "Offline" / a cloud icon with a slash

AgendaDeck couldn't reach your calendar provider. Common causes:

iCloud says "Authentication failed"

Double-check that you're using an app-specific password, not your real Apple ID password. The 16-character password is shown with hyphens at appleid.apple.com — you can paste it with or without hyphens, both work. If you have two-factor authentication on your Apple ID (you should), the regular password will not work; only an app-specific password will.

"This account is not allowed by your organization"

Your IT admin needs to consent to AgendaDeck's calendar read scope. See Connect Microsoft 365 / Outlook above.

The countdown is wrong by an hour

Almost always a daylight-savings or timezone mismatch between your computer's clock and the calendar event. Make sure the system clock and timezone are set automatically (System Settings → Date & Time on macOS, Settings → Time & Language on Windows). Then long-press any AgendaDeck key to force a refresh.

I want to delete all my data

In the Property Inspector, click Disconnect account. That single action revokes the OAuth token at the provider, deletes the local cache, and clears the stored credentials. See the privacy policy for details.

Contact us

For anything not covered above, email support@agendadeck.com. Response SLA is two business days. For security-sensitive reports, please write SECURITY in the subject line — those are triaged within one business day.