Docs
Everything Scalendar can do, written down.
Five-minute install. Two-minute first event. The rest of these docs are for when you want to do something specific.
Install Scalendar
You'll need to be a Slack workspace admin or owner to install Scalendar. The install takes about 30 seconds and asks for a minimal set of OAuth scopes — listed in plain English below.
- Click any Add to Slack button on this site — they all kick off the Slack OAuth flow.
- Pick the workspace you want to install into.
- Review the scopes, then click Allow.
- Slack drops you back into our thank-you page. You're done.
Scopes we ask for
Slack will show you this list before you approve. Here it is up front, no surprises — five scopes, each tied to one specific thing Scalendar needs to do.
| Scope | Why we need it |
|---|---|
commands | Listen for /calendar slash commands in channels Scalendar has been added to. |
chat:write | Post event cards and reminder messages to those channels. |
channels:read | Read the channel name and ID so the calendar knows where it lives. We never read message history. |
app_mentions:read | Respond when someone @mentions Scalendar — that's the only time we see those messages. |
users:read | Show event creator display names. We never read emails, phone numbers, or other profile fields. |
For the long-form legal version, see our privacy policy.
Your first calendar
Calendars live inside Slack channels. Open the channel you want to give a calendar — say #team-launchpad — and run:
Scalendar pops a modal asking who can add events. Pick one:
- View only — channel members can view events; only admins can add them.
- Open — anyone in the channel can view and add.
Hit Create calendar. Scalendar posts a confirmation message in the channel and you're off.
Adding your first event
In any channel with a calendar, run:
Five fields:
- Title — what is it?
- Date & time — when does it start?
- Duration / end — how long?
- Description — optional, but nice for context.
- Reminder — when to ping the channel.
Submit. Event lands in the channel as a Block Kit card and is added to your channel calendar. Done.
Slash commands
Everything Scalendar can do, from the keyboard:
| Command | What it does |
|---|---|
/calendar create | Create a calendar in the current channel (channel admins only). |
/calendar add | Open the event-creation Block Kit modal. |
/calendar view | List upcoming events in the channel. |
/calendar view week | Filter the view to this week. |
/calendar view month | Filter the view to this month. |
/calendar help | The commands list, but inside Slack. |
Permissions
Two layers — channel and event.
Channel-level
- Channel owners and admins can create, configure, and delete the calendar.
- All members can always view events.
- Adding events depends on the calendar's permission mode (View-only vs Open).
Event-level
- Event creators can edit and delete their own events.
- Calendar admins can edit and delete any event.
Reminders
Reminders fire as a channel message before an event starts. On Free, every calendar uses a fixed 15-minute lead. On Premium and up, you can also:
- Change the default lead time for an entire calendar.
- Override per-event with custom timing (e.g. 1 day before).
- Stack multiple reminders on a single event, each with its own timing.
- Direct-message the reminder to specific users instead of (or in addition to) the channel.
App Home tab
Click Scalendar in your Slack sidebar to open the Home tab. It shows:
- Every calendar you have access to, grouped by channel.
- Your next seven days, sorted, with one-click jump into any event.
- Your current plan and calendar usage.
Plans & billing
See the full breakdown on the pricing page. Billing is per workspace, monthly, via Stripe. Annual billing saves 20%.
Uninstalling
Open Apps in your Slack workspace settings → Scalendar → Remove app. Your calendars and events are retained for 30 days in case you change your mind, then permanently deleted.
Security
- OAuth tokens encrypted at rest (AES-256).
- HTTPS everywhere. TLS 1.2 or higher.
- Slack request signatures verified on every webhook (HMAC-SHA256).
- Just-in-time database access for engineers, with full audit logs.
For the full security write-up — infrastructure, access controls, compliance — see the privacy policy.
FAQ
Can Scalendar read my channel messages?
No. We only see slash commands typed at /calendar and events you explicitly create. Regular channel messages are never visible to Scalendar.
Will it work in private channels?
Yes — provided Scalendar has been added to the channel. Slack gates that; we just do calendars.
Can I export to Google Calendar or Outlook?
iCal export is on our roadmap. Two-way sync with Google and Outlook is the release after that.
Do you support multiple Slack workspaces?
Yes — install Scalendar separately in each workspace. Billing and calendars are scoped per workspace.
Get support
Free plan: email hello@scalendar.app. We aim for a 48-hour first response.
Premium and Enterprise: priority queue with a 24-hour SLA, plus a dedicated Slack Connect channel on Enterprise.
Ready to stop reading and start scheduling?
The fastest way through these docs is to install Scalendar and try the commands yourself.
Join waitlist