Google Workspace
Setup and permissions
This is the current app flow for connecting a Google account through browser approval, checking status, and running re-consent when required scopes are missing.
Connect a Google account for the first time
- 1
Open the connection screen from the sidebar.
- 2
Move to the work tool channels view and find the Google card.
- 3
Press Connect to open the Google approval page in your browser.
- 4
After approval, return to the app and let Semo check the account automatically.
- 5
When the connection is complete, the card shows the account email and the services currently available from its granted scopes.
Statuses and primary card action
| Status | Meaning | Primary card action |
|---|---|---|
| connected | The Google account and required scopes are fully ready | Disconnect only |
| connecting | The app is waiting for browser approval or rechecking the account | Check now |
| disconnected | The account record remains, but the live connection is off | Reconnect |
| consent_incomplete | The account exists, but some required scopes are missing | Re-consent |
| error | The most recent connection or validation step failed | Reconnect |
Permission coverage by service
A connected account can still be partially blocked
If some scopes are missing, the account may still exist on the card but the related Google service will not work until you run Re-consent.
| Service | Current permission coverage | How to explain it in docs |
|---|---|---|
| Gmail | Mail read, draft, and send preparation | Mail search, read, compose, and reply |
| Calendar | Calendar list plus event read/create/update/delete | Schedule review and management |
| Drive | File search, read, and upload | File management and text extraction |
| Docs | Google Docs creation and text append | Document creation and text continuation |
| Sheets | Google Sheets creation and value append | Spreadsheet updates focused on appending values |
| Tasks | Task list read, task create, task update, and complete | Task management |
Multiple accounts and the active default
- 1
Open the overflow menu on the Google card.
- 2
Review the list of connected Google accounts.
- 3
Choose another account to make it the active default account.
- 4
Use Add account if you want to connect another Google account through the same browser flow.
- The UI keeps one Google card even when multiple accounts are connected.
- The currently selected account controls the summary shown on the card and the default sender state.
Disconnect, reconnect, and re-consent
- When the card is connected, the primary action becomes Disconnect only and removes the live work tool connection without removing the stored account record.
- When the card is disconnected or in error, the primary action becomes Reconnect for the same account.
- When the card is consent_incomplete, the primary action becomes Re-consent so you can approve the missing scopes.
- If the browser window was closed while the card is still connecting, use Check now to re-query the current state from the app.