Google Classroom Discord Bot

(Working in progress)

Current progress:

  • function to retrieve to-do assignments
  • bot command to send the assignment list
  • improvements on the speed of the assignments command
  • bot command to get the timetable


( Bot prefix: $ )


The bot will reply with ‘test’.
For testing purposes.


Get assignment lists
Takes around 1 minute to run


  • requires: Google API OAuth2 Token (stored as ./credentials.json)
  • discord bot (token stored in ./secrets.json)

// secrets.json

To get google api credentials:

  1. Visit Google Cloud Platform and sign in using your personal account (not your school account)
    • Only education accounts aged 18 or above / perseonal accounts aged 13 or above can access to this service
  2. Create a new project for ‘web application’
  3. In the Libraries tab (under API & Services) search for ‘Google Classroom API’ and enable it
  4. In the Credentials tab (just below the Libraries tab), press ‘Create Credentials’ and choose OAuth client ID
  5. Set application type to ‘web application’, under the ‘Authorized redirect URIs field add uri ‘https:/6localhost:59821/
  6. Press Create and wait for a pop-up menu which says ‘OAuth client created’. In the menu press ‘DOWNLOAD JSON’
  7. Move the downloaded file to your working directory and rename it as credentials.json
  8. run py .\ in command prompt/terminal
  9. A browser window will pop up, sign in and authorize using the school account ([email protected])

Creating a bot

  1. Go to Discord Developer Portal
  2. Create an application
  3. In the bot tab, create a bot
  4. In the URL Generator under OAuth2 Category in the sidebar, generate an URL and copy it
    • with scopes “Bot”, “” and “applications.commands”
    • with bot permission “Administrator”
  5. In the bot tab, under Intents section, enable:
  6. Go to the link obtained in step 4, complete the authorization to add the bot


View Github