Google Calendar User Guide
Learn how to use Google Calendar integration as a team member
Getting Started
Google Calendar integration allows you to bring your calendar events directly into Discord. You can view upcoming events, RSVP to meetings, and get notifications without leaving your chat.
You need a Google account and Team Toolbox must be added to your Discord server.
Authentication
Before using calendar features, you need to connect your Google account to Team Toolbox.
Start Authentication
Type /google auth in any channel where Team Toolbox is present.
/google auth
Follow the Link
Team Toolbox will send you a private message with a secure authentication link. Click the link to open Google's authorization page.
Grant Permissions
Authorize Team Toolbox to access your Google Calendar. We only request the minimum permissions needed for the features to work.
Team Toolbox uses OAuth2 and never sees your Google password. You can revoke access at any time through your Google Account settings.
Basic Commands
Once authenticated, you can use these commands to interact with your Google Calendar:
/calendar list_calendars
Lists all calendars you have access to, including their IDs needed for other commands.
/calendar list_events [calendar_id]
Shows upcoming events from a specific calendar. If no calendar_id is provided, shows events from your primary calendar.
/calendar create_event
Creates a new calendar event. You'll be prompted to fill in the details through an interactive form.
Event Management
Team Toolbox makes it easy to manage your calendar events without leaving Discord.
Creating Events
Use the /calendar create_event command to create new events. The bot will guide you through the process with an interactive form.
Viewing Events
Events are displayed with rich embeds showing all the important details:
- Event title and description
- Date and time (converted to your timezone)
- Location or meeting link
- Attendee list
- RSVP buttons for quick responses
RSVP to Events
When Team Toolbox shows calendar events, you'll see RSVP buttons:
- ✅ Accept - Confirm your attendance
- ❓ Maybe - Tentative attendance
- ❌ Decline - Can't attend
Notifications
Get notified about calendar events directly in Discord channels.
Channel Subscriptions
Admins can subscribe Discord channels to Google Calendars. When subscribed, the channel will receive notifications for:
- New events created
- Event updates and changes
- Event reminders
- Event cancellations
Personal Notifications
You can customize your personal notification preferences using the dashboard at teamtoolbox.app/dashboard:
- Enable/disable notifications for new events
- Control notifications for event updates
- Manage cancellation notifications
Troubleshooting
Commands not working
Issue: Team Toolbox doesn't respond to calendar commands
Solution:
- Make sure you're authenticated with
/google auth - Check that Team Toolbox has permission to read/send messages in the channel
- Try using the commands in a different channel
Not seeing all calendars
Issue: Some of your Google Calendars don't appear in the list
Solution:
- Check calendar sharing settings in Google Calendar
- Make sure the calendar is not hidden
- Re-authenticate with
/google authto refresh permissions
Missing notifications
Issue: Not receiving event notifications in Discord
Solution:
- Ask an admin to check if the channel is subscribed to your calendar
- Verify your notification preferences in the dashboard
- Check if you have permissions to see the notification channel
Join our Discord community or contact support for additional assistance.