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.9 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 five new AgendaDeck actions: Next, Timeline Slot, Agenda, Free Time, and Day Load.
  5. Drag any AgendaDeck action onto a key. The Property Inspector will open with buttons to connect a calendar account: Connect Google, Connect Outlook, and Connect iCloud. All five actions share the accounts you connect — you only sign in once.

Connect Google Calendar

  1. With any AgendaDeck action selected, click Connect Google in the Property Inspector.
  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 (calendar.readonly), plus your email address for labelling the account. Click Allow.
  4. Google hands the sign-in back to the Stream Deck app automatically (you may briefly see a redirect through Elgato's secure callback). You can close the browser tab — the Property Inspector should now show your account email and let you pick which calendars to display.

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 Outlook.
  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 the requested permissions: Calendars.Read (read your calendars), User.Read (your name and email, used to label the account), and offline_access (so AgendaDeck can refresh access without making you sign in again). 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 and let you pick which calendars to display.

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, click Connect iCloud, enter your Apple ID email, and paste the app-specific password.
  5. Click Connect. The plugin signs in to Apple's CalDAV server (caldav.icloud.com), discovers your calendar home, and confirms the connection. You can then pick which calendars to display.

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.

The five tiles

All five tiles read from the same connected accounts. For each account you can choose which calendars are included using the calendar picker in the Property Inspector — declined events and all-day events are skipped automatically so the key always reflects what you actually need to be at.

Most tiles act on a press. AgendaDeck joins a meeting when it's about to start — within your Join window, 15 minutes by default and configurable in the plugin settings — and otherwise opens the event so you can see what it is. When a press will join, the key glows.

Next

A live countdown to your next meeting. The key colors itself by urgency automatically — calm when your next event is far off, shifting to a warning tint as it approaches, and an "in progress" state once it has started. Tap to join if it's within your Join window, otherwise it opens the event; long-press opens the event details without joining. The key glows when a press will join.

Timeline Slot

Place several Timeline Slot keys in a row to render your whole day as a ribbon of busy/free across your deck. Each key maps to a fixed window and shows free, busy, or "starting soon" — together they turn a row of your deck into a calendar bar. Tap a slot to join if that slot's meeting is imminent, otherwise it opens the event; long-press opens the event. The imminent slot glows.

Agenda

Page through your day's meetings on a single key. Tap the key to step to the next meeting; long-press to join the meeting you're currently looking at. If you stop pressing, the key automatically snaps back to the live event after a few seconds, so it's always showing what's relevant without any input.

Free Time

How long until your next meeting, at a glance — a green "free for" readout that counts down to your next event. Tap to open your next meeting.

Day Load

How heavy today is across all your calendars — total meetings and time in meetings at a glance. Tap to cycle the readout between the total, a per-account breakdown, and your longest free gap.

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 next to the affected 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 next to the account. This deletes the local cache and clears the stored credentials immediately. For Google and Microsoft it also revokes the OAuth token at the provider. For iCloud, there is no remote token to revoke — to invalidate the app-specific password, remove it from your Apple ID app-specific password list. 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.