Connected apps
Google Workspace
Connect Gmail, Google Calendar and Google Drive, for the company or for yourself.
# Google Workspace Google Workspace brings three apps: **Gmail** (labels, messages and attachments), **Google Calendar** (calendars and events) and **Google Drive** (My Drive, shared drives and their folders). They are listed together on the Connections page. The brain reads from them, and with your approval in the chat it can save two things: a draft in Gmail and a new Google Doc. It never sends email, and it never changes or deletes anything already in Google. ## What each one reads - **Gmail** reads the labels you share, one email per message. Inbox, Sent, Starred and Important can be shared, and so can your own labels. Sharing a label shares the labels nested inside it, so sharing "Clients" also shares "Clients/Acme". Attachments the brain can read become their own documents; the rest are counted as skipped. Spam and Trash are never read. A message that carries two shared labels is one document. - **Google Calendar** reads the calendars you share, one document per event: its title, time with the time zone, organiser, who was invited and their answers, location, the join link and the description. A repeating event is one document with how it repeats. Cancelled events leave the brain. - **Google Drive** reads the folders you share and everything inside them. Google Docs are read as Word files, Sheets as Excel files and Slides as PDFs. PDFs, Word, Excel, text and Markdown files are read as they are. Photos, scans and other formats are counted under **Can't read yet**. How far back the first read of mail goes, how many days of the calendar the brain keeps, and the largest file it reads, are set by your deployment. Mail and events stay in the brain after they age past those limits; they leave only when they are deleted or no longer shared. During a chat, the brain can also search the shared Gmail labels and read a message from them, list events in the shared calendars for a time range, and search the shared Drive folders, all live. It cannot see outside what is shared. ## Drafts and docs Two tools write, and each one asks first with an approval card. See [Approving writes](https://docs.skilltreeos.ai/chats/approving-writes/). - **Gmail drafts:** the brain saves an email to your Drafts, with the recipients, subject and message you approved. Nothing is sent; you send it from Gmail yourself. - **Google Docs:** the brain creates a doc in your own Drive, in a folder if you name one. If the folder cannot take files from the brain, the doc goes to My Drive and the card says so. Both write into the account of the person asking: their own connection, or the company connection only when they are the admin who made it. Google asks for two extra permissions for this, **compose drafts** for Gmail and **files this app creates** for Drive. They are optional on Google's page: a connection without them still reads, and **Connected apps** shows **Reconnect** with a line such as **Reconnect to allow drafts**. Reconnecting the same account keeps everything shared. ## Company-wide connection (admin only) An admin connects each app under **Settings**, on the **Connections** tab, then chooses what to share. The connection reads through the admin's own Google account. Google asks the admin to approve read access, plus the optional permission for drafts or for docs; leave the box for reading ticked on Google's page, or the connection is refused. People who meet in shared calendars also appear on the knowledge graph, linked to the meetings they organised and attended. ## Personal connections On the same tab, each Google app has a switch, **Employees can connect their own**. It is off by default. When an admin turns it on: - Every employee sees a **Just for you** line on the app in **Connected apps**, with **Connect**, then **Manage**. - They link their own Google account and pick their own labels, calendars or folders. Only they can ask about it, and its documents show as **Private**. - The admin sees who connected, by name, and can disconnect a person. The admin cannot see what they shared. Switching it off disconnects everyone's personal connection and removes what they shared. A personal calendar never adds people or meetings to the knowledge graph. Disconnecting one Google app keeps the others you connected with the same Google account working. Google's own access for this workspace is withdrawn when the last of them is disconnected. For how sharing and removal work, see [Sharing folders and areas](https://docs.skilltreeos.ai/connected-apps/sharing-folders-and-areas/).Google Workspace brings three apps: Gmail (labels, messages and attachments), Google Calendar (calendars and events) and Google Drive (My Drive, shared drives and their folders). They are listed together on the Connections page. The brain reads from them, and with your approval in the chat it can save two things: a draft in Gmail and a new Google Doc. It never sends email, and it never changes or deletes anything already in Google.
What each one reads
Section titled “What each one reads”- Gmail reads the labels you share, one email per message. Inbox, Sent, Starred and Important can be shared, and so can your own labels. Sharing a label shares the labels nested inside it, so sharing “Clients” also shares “Clients/Acme”. Attachments the brain can read become their own documents; the rest are counted as skipped. Spam and Trash are never read. A message that carries two shared labels is one document.
- Google Calendar reads the calendars you share, one document per event: its title, time with the time zone, organiser, who was invited and their answers, location, the join link and the description. A repeating event is one document with how it repeats. Cancelled events leave the brain.
- Google Drive reads the folders you share and everything inside them. Google Docs are read as Word files, Sheets as Excel files and Slides as PDFs. PDFs, Word, Excel, text and Markdown files are read as they are. Photos, scans and other formats are counted under Can’t read yet.
How far back the first read of mail goes, how many days of the calendar the brain keeps, and the largest file it reads, are set by your deployment. Mail and events stay in the brain after they age past those limits; they leave only when they are deleted or no longer shared.
During a chat, the brain can also search the shared Gmail labels and read a message from them, list events in the shared calendars for a time range, and search the shared Drive folders, all live. It cannot see outside what is shared.
Drafts and docs
Section titled “Drafts and docs”Two tools write, and each one asks first with an approval card. See Approving writes.
- Gmail drafts: the brain saves an email to your Drafts, with the recipients, subject and message you approved. Nothing is sent; you send it from Gmail yourself.
- Google Docs: the brain creates a doc in your own Drive, in a folder if you name one. If the folder cannot take files from the brain, the doc goes to My Drive and the card says so.
Both write into the account of the person asking: their own connection, or the company connection only when they are the admin who made it. Google asks for two extra permissions for this, compose drafts for Gmail and files this app creates for Drive. They are optional on Google’s page: a connection without them still reads, and Connected apps shows Reconnect with a line such as Reconnect to allow drafts. Reconnecting the same account keeps everything shared.
Company-wide connection (admin only)
Section titled “Company-wide connection (admin only)”An admin connects each app under Settings, on the Connections tab, then chooses what to share. The connection reads through the admin’s own Google account. Google asks the admin to approve read access, plus the optional permission for drafts or for docs; leave the box for reading ticked on Google’s page, or the connection is refused.
People who meet in shared calendars also appear on the knowledge graph, linked to the meetings they organised and attended.
Personal connections
Section titled “Personal connections”On the same tab, each Google app has a switch, Employees can connect their own. It is off by default. When an admin turns it on:
- Every employee sees a Just for you line on the app in Connected apps, with Connect, then Manage.
- They link their own Google account and pick their own labels, calendars or folders. Only they can ask about it, and its documents show as Private.
- The admin sees who connected, by name, and can disconnect a person. The admin cannot see what they shared.
Switching it off disconnects everyone’s personal connection and removes what they shared. A personal calendar never adds people or meetings to the knowledge graph.
Disconnecting one Google app keeps the others you connected with the same Google account working. Google’s own access for this workspace is withdrawn when the last of them is disconnected.
For how sharing and removal work, see Sharing folders and areas.