Task Manager can display events from your Google Calendar in its own Calendar and sync them both ways: changes made in Google appear automatically in Task Manager every few minutes, while changes made in Task Manager are saved to Google immediately. Google events are visible only to you - the connection is personal, just like your mailbox.

You can connect several accounts at once - for example, your company calendar and your personal one. Each connection has its own calendar and works independently.

This guide has three parts:

  • Part A - for an administrator, once only: set up a “pass” in Google (without it, no one can connect their account).
  • Part B - for each user: how to connect your Google account.
  • Part C - optional: a private calendar using your own “pass” (only needed in special cases).

Part A (administrator, completed once): a pass in Google

Google requires every app that connects to Calendar to have its own “pass” - known as OAuth credentials (two long strings: Client ID and Client Secret). You set them up once, for free, in the Google Cloud console. It takes about 10 minutes. Here’s how:

Step 1. Create a project

  1. Go to console.cloud.google.com and sign in with a Google account (preferably your company account).
  2. At the top of the page, click the project list and select New project (New project).
  3. Name it, for example, Task Manager, click Create (Create) and wait a moment for Google to set it up. Make sure it is selected (its name should be visible at the top).

Step 2. Enable the Google Calendar API

  1. From the menu on the left, select APIs & Services → Library (APIs & Services → Library).
  2. Enter Google Calendar API in the search box, click the result, then click Enable (Enable).

Step 3. Configure the consent screen

This is the window users will see when connecting their account (“App X wants access to your calendar”).

  1. From the menu on the left, select APIs & Services → OAuth consent screen (OAuth consent screen). In the newer version of the console, this section is called Google Auth Platform (Google Auth Platform) - if so, click Get started (Get started).
  2. Enter the application name (for example, Task Manager) and your contact email address.
  3. Recipient type (User type / Audience):
    • Internal - only if the company uses Google Workspace. The most convenient option: no warnings, but only accounts from the company's domain can connect (a personal Gmail account won't connect - see Part C).
    • External (External) - use this in every other case. It works with any Google account.
  4. Save / Create.
  5. Important for the External type: in the Audience section, click Publish app to change the status from “Testing” to “In production”. In testing mode, Google disconnects everyone every 7 days, so they have to connect again.

Step 4. Create an OAuth client (the actual pass)

  1. From the menu on the left, select APIs & Services → Credentials (Credentials) - or Clients (Clients) in the new console.
  2. Click Create credentials → OAuth client ID (Create credentials → OAuth client ID).
  3. Application type: Web application (Web application).
  4. Name: for example, Task Manager.
  5. Now for the most important field: Authorised redirect URIs (Authorized redirect URIs). Click Add URI and paste EXACTLY the address shown by Task Manager under Settings → Advanced → Google Calendar (OAuth) - it ends with /api/gcal/oauth-callback.
    • Note: Do NOT paste this address into the “Authorised JavaScript origins” field - that’s a different field and it will cause an error. Leave it empty.
  6. Click Create. Google will display the Client ID (Client ID, ending in .apps.googleusercontent.com) and Client Secret (Client Secret, beginning with GOCSPX-). Copy both.

Step 5. Paste the pass into Task Manager

  1. In Task Manager, open Settings → Advanced → Google Calendar (OAuth).
  2. Paste the Client ID and Client Secret, then click Save.

Done - every user can now connect their account (Part B).

For the External type, Google will show a one-off warning when connecting: “Google hasn’t verified this app”. This is normal for business apps - click Advanced, then Go to <name>. The limit for an unverified app is 100 connected accounts.

Part B (each user): connect your account

  1. Open Settings → Profile → Google Calendar.
  2. Click Connect Google account.
  3. Google will ask which account you want to sign in to - select the one whose calendar you want to see (company or personal).
  4. If the warning “Google hasn’t verified this app” appears, click Advanced, then Go to (this is a one-off; see Part A).
  5. Allow access to the calendar (Allow / Allow).
  6. You will return to Task Manager. Open Settings → Profile → Google Calendar again - a list of your calendars will appear next to the connected account.
  7. Select a calendar and click Import. After a moment, its events will appear in the Task Manager Calendar.

Want to add another calendar, such as your personal one? Return to the same section and click Connect Google account again - this time, sign in to the other account. Each connection appears as a separate card in the list, with its own calendar and Disconnect button.

The import covers a window of 30 days back and one year ahead - you can change it in the “Window” fields for each connection.

Part C (advanced): connecting a personal calendar with your own pass

When is this needed? Mainly when the company pass is set to Internal (Internal) - Google will then prevent you from connecting your personal Gmail account. In this case, you can create your own pass using your personal Google account and connect with it:

  1. Complete all of Part A using your personal Google account (your own project, External type, publication, and your own Client ID and Secret). In step 4.5, paste the redirect address shown in the section below.
  2. In Task Manager, open Settings → Profile → Google Calendar and expand Connect with your own credentials (advanced).
  3. There you will find the redirect address (for step 4.5) and the Client ID and Client Secret fields - paste your credentials and click Connect with your own credentials.
  4. Then proceed as in Part B: sign in, grant consent, select a calendar and click Import.

Your credentials are stored in encrypted form and used only for this one connection. The administrator does not need to do anything.

How Google events work in Task Manager

  • In Calendar, they use Google’s colours: the colour assigned to the event, or, if it has none, the colour of the selected calendar (very light colours are slightly darkened for readability). Events sent from Task Manager to Google get the closest colour from Google’s palette - the colours are approximate because the two apps use different palettes. Click an event to see “Event from Google” in the edit window, with a link to open it in Google.
  • You can edit them just like any other event: drag them to another date or time, change their times and content, or delete them. Every such change is also saved to Google Calendar - and changes made in Google are automatically imported into Task Manager every few minutes.
  • Don’t want to wait? Click the sync icon (two arrows in a circle) in the Calendar window’s top bar. It only appears when you have Google Calendar connected and pulls in changes straight away - handy when you’ve just changed something in Google and want to see it here right now. When it’s done, a message tells you how many events were added, changed and removed. The same button (“Sync now”) is available next to the connection in Settings → Profile → Google Calendar.
  • If the last automatic synchronisation failed, the icon turns orange, and hovering over it shows the reason. Click it to try again.
  • New events created in Task Manager are also sent to Google: once you select a calendar, the option “Add new events from Task Manager to this calendar” is enabled (shown next to the connection in Settings). Enabling it also immediately sends future events that have not yet been sent. If you have several connections, exports go to one selected calendar - selecting a calendar in another account switches the destination. Exported events keep their colour and continue to sync both ways (deleting one in Google also deletes it for you).
  • Deleting an event also deletes it in Google (the edit window makes this clear); “Undo” in the toolbar restores the event on both sides.
  • Clicking opens the standard edit window with an open in Google link.
  • Future events send reminders just like regular Task Manager events (a notification at the start time); past events are added silently to the day's history.
  • All-day events are shown from 8:00 (multi-day events - until 18:00 on the final day) and remain all-day events in Google when moved to another day.
  • Disconnect (next to a specific connection) removes events imported from that account from your calendar - nothing is deleted from Google. Other connections continue to work.
Task Manager: calendar with events pulled from a Google account.
Events from Google sit in the grid alongside tasks and the team's absences.

Deleting Google account data

  • Disconnecting one account: Settings → Profile → Google Calendar → Disconnect next to the selected connection. The tokens and events imported into your calendar are removed (nothing changes in Google); other connections continue to work.
  • Deleting instance credentials (administrator): Settings → Advanced → Google Calendar (OAuth) → Delete credentials. This deletes the Client ID and Client Secret and disconnects all users connected through these credentials (their imported events disappear from Task Manager; nothing changes in Google). Connections using their own credentials (Part C) remain unaffected.
  • You can also revoke the application's access to your Google account at any time in Google: myaccount.google.com → Security → Third-party apps and services.

Troubleshooting

  • “The administrator has not configured credentials yet” - Part A has not been completed (or you can use your own credentials - Part C).
  • Google says “You don’t have access” for a personal account - the organisation’s pass is set to Internal; use Part C.
  • “Reconnect account” error - Google has revoked access (for example, after a password change, revoking consent in your Google account, or because the app is in testing mode - see Part A, step 3.5). Disconnect and reconnect the account.
  • “redirect_uri_mismatch” error when connecting - the redirect address in Google Cloud differs from the one shown by Task Manager (Part A, step 4.5). Correct it in Google Cloud (Credentials → Your OAuth client).
  • Synchronisation takes place whenever anyone is using the application (via the built-in scheduler); after a longer break, the first sync will run shortly after the application is opened.
  • A change from Google hasn't appeared after a few minutes? Click the synchronisation icon in the Calendar bar - you'll see either the number of changes downloaded or the specific reason for the failure. The status of the last run (date and any error) is also shown under Settings → Profile → Google Calendar.