Google Calendar Admin Guide
Set up and manage Google Calendar integration for your server
Getting Started
As an admin, you can configure Google Calendar integration for your entire Discord server, including organization-wide authentication and automatic channel subscriptions to team calendars.
You need Discord server administrator permissions and Google Workspace admin access for organization features.
Screenshot needed: Admin dashboard showing Google Calendar integration setup (1200x600px)
Organization Setup
Configure domain-wide delegation to allow Team Toolbox to manage calendars for your entire organization.
Enable Organization Mode
Use /google auth organization to enable organization-wide integration. This requires Google Workspace admin privileges.
Configure Service Account
Set up domain-wide delegation in your Google Admin Console to allow Team Toolbox to access user calendars.
Screenshot needed: Google Admin Console domain-wide delegation setup (800x400px)
Verify Setup
Test the integration with /google status to ensure proper configuration.
Organization mode grants broad access to user calendars. Only enable if you trust Team Toolbox with your organization's calendar data.
Channel Subscriptions
Set up automatic calendar notifications in Discord channels for team meetings and events.
Basic Subscriptions
/calendar subscribe_channel
Subscribe a Discord channel to receive notifications from specific Google Calendars
/calendar unsubscribe_channel
Remove calendar subscriptions from a Discord channel
Notification Settings
Configure when and how calendar notifications are sent:
- Event creation: New events added to subscribed calendars
- Event updates: Changes to event details, time, or attendees
- Reminders: Configurable advance notifications (15 min, 1 hour, 1 day)
- RSVP tracking: Show attendance status and allow Discord RSVPs
GIF needed: Setting up channel subscriptions workflow (600x400px)
Permissions
Configure who can access Google Calendar features and manage subscriptions.
Required Discord Permissions
- Send Messages: Post calendar notifications
- Embed Links: Rich calendar event displays
- Use External Emojis: Calendar status indicators
- Add Reactions: RSVP functionality
User Access Control
Control which users can:
- View calendar events in Discord
- Create reminders from calendar events
- RSVP to events through Discord
- Access their personal calendar integration
Create dedicated calendar notification channels to avoid cluttering general chat channels.
Advanced Features
Out of Office Integration
Automatically sync Google Calendar out-of-office status with Discord roles or status.
/google ooo_settings
Configure out-of-office role assignments and status updates
Calendar Access Management
For organization mode, manage which calendars are accessible:
- Individual user calendars
- Shared team calendars
- Resource calendars (meeting rooms, equipment)
- Public organization calendars
Webhook Configuration
Set up webhooks for real-time calendar updates and custom integrations with other team tools.
Troubleshooting
Organization setup fails
Issue: Domain-wide delegation not working
Solution:
- Verify you have Google Workspace Super Admin privileges
- Check that the service account is properly configured in Google Admin Console
- Ensure the correct OAuth scopes are authorized
- Wait up to 24 hours for changes to propagate
Channel subscriptions not working
Issue: Calendar notifications not appearing in Discord
Solution:
- Check Discord permissions for the bot in the target channel
- Verify the calendar is shared with the service account
- Test with
/calendar test_subscription - Check webhook delivery logs in the admin dashboard
Performance issues with large organizations
Issue: Slow calendar sync or rate limiting
Solution:
- Enable selective calendar sync for high-activity calendars
- Adjust notification frequency to reduce API calls
- Contact support for enterprise rate limit increases
Join our Discord community or contact support for admin-specific assistance.