Google Workspace

The Google Workspace integration lets you work with Gmail, Google Calendar, and Google Drive directly from meinGPT: read and write emails, manage events, and search files in Drive.

Gmail, Calendar, and Drive are separate connectors. You activate exactly the ones you need in a chat or assistant.

Overview

Execution runs in user context: tool calls use the permissions of the authenticated user. This ensures chats and assistants only access data the current user is allowed to see.

Google Workspace is Google's integrated suite of cloud-based productivity and collaboration tools. With the meinGPT integration, you can:

Gmail:

• List and read emails
• Search emails by various criteria (sender, subject, content)
• Access message details and content
• Filter emails by labels
• Create and edit drafts, send emails

Deleting emails is not currently supported.

Google Calendar:

• List available calendars and their details
• View calendar events for any date range
• Get detailed information about specific events
• View meeting attendees and details
• Create, update, and cancel events
• Invite attendees (this sends notifications)

Google Drive (read-only):

• List, filter, and sort files
• Search files by text and file type
• Retrieve file metadata
• Load selected files into the chat

Setup

The Google Workspace integration uses OAuth authentication, so no manual API key configuration is required.

Steps to activate:

1. Activate tools: Select the Google tools you need (Gmail, Google Calendar, and/or Google Drive) in your assistant, or enable them directly in a chat via the "+" menu
2. Authentication: On first use, you'll be automatically redirected to Google
3. Select account: Choose the Google account you want to access
4. Confirm permissions: Review and accept the requested permissions (depending on the activated tool):
   • Read Gmail messages, create drafts, and send emails
   • View and manage calendars and events
   • Read Google Drive files
5. Done: After successful authentication, you can start working with Google Workspace immediately

Available Features

Gmail Features

List Emails

Display emails based on various criteria:

"Show me the last 10 emails"
"Search for emails from customer@example.com"
"Find all unread emails in inbox"
"Show emails with subject 'Invoice'"

Get Email Details

Access complete email content:

"Show me the content of email with ID xyz123"
"Read the latest email from my boss"

Advanced Search

Use Gmail search syntax for precise queries:

"Search emails: from:support@example.com subject:Ticket"
"Find emails with attachments from last month"
"Show important emails from this week"

Google Calendar Features

List Calendars

Show all available calendars:

"What calendars do I have?"
"Show me all my Google calendars"

View Events

Overview your appointments and meetings:

"What's on my calendar today?"
"Show me all events for next week"
"What meetings do I have tomorrow?"
"What's my next appointment?"

Event Details

Get detailed information about events:

"Show details for the 2 PM meeting"
"Who's attending the project meeting?"
"Where is the team event taking place?"

Google Drive Features

Google Drive is connected as read-only: you can find files and load them into the chat, but not create or change anything in Drive.

Find Files

Search your Drive by content or file type:

"What files are in my Drive?"
"Search Drive for the presentation 'Quarterly Report'"
"Find all PDFs in this folder"

Load Files into the Chat

Hand a found file to the assistant:

"Load the file 'Offer.docx' into the chat"
"Take the most recently changed spreadsheet as context"

Restrict Access to Folders (optional)

• Default Folder: Sets which folder is used for listing and searching when no specific folder is given.
• Restrict to Folders: If left empty, the assistant has full access to your Drive. Once you select one or more folders, the assistant can only access files within those folders.

Shared Drives

The assistant can also search and list files in shared (team) drives, in addition to your personal Drive.

Usage Examples

You get the most value when the assistant combines several services:

"Show me all appointments for tomorrow with attendee lists and find the related emails about the client meeting"
"Summarize the most important unread emails from today and draft suitable replies"
"Create an overview of my meetings this week and load the related presentation from Drive"

Gmail Search Operators

Use these advanced search operators for precise email searches:

• from: - Emails from specific senders
• to: - Emails to specific recipients
• subject: - Emails with specific subject lines
• label: - Emails with specific labels
• has:attachment - Emails with attachments
• is:unread - Unread emails
• is:important - Emails marked as important
• after: / before: - Emails after/before a specific date

Benefits

• Direct Integration: Access Gmail, Calendar, and Drive without context switching
• Automatic Authentication: No manual API key management
• Natural Language: Use everyday language instead of complex commands
• Read and Write: Emails and events can not only be retrieved, but also created, changed, and sent
• Advanced Search: Use the complete Gmail search syntax
• Real-time Data: Work with current information from your account
• User-Level Permissions: Access is limited to resources the current user is authorized for

Large-scale search via data pools

Besides native connector mode, Gmail/calendar-adjacent knowledge can be indexed into data pools and searched at scale in RAG scenarios.

• useful for larger communication and knowledge datasets
• better for centralized enterprise-wide retrieval
• important: native user-level permissions from connector mode do not carry over automatically

Best Practices

1. Precise Search Queries: Use specific criteria for better results
2. Define Time Ranges: Specify date ranges to get relevant results
3. Use Labels: Utilize Gmail labels for organized searches
4. Calendar IDs: Use 'primary' for your main calendar
5. Privacy Awareness: Share sensitive information responsibly

Limitations

• Google Drive read-only: In Drive you can search and load files, but not create or change files
• Gmail deletion not available: The assistant can read emails, create drafts, and send, but cannot delete emails
• Permissions: Access only to authorized calendars and emails
• Rate Limits: According to Google API restrictions
• Attachments: Attachment contents are not displayed directly
• HTML Emails: HTML formatting is displayed as raw text

Privacy and Security

• Authentication is secure via OAuth 2.0
• meinGPT does not store Google credentials
• All data is transmitted encrypted
• Write actions (sending email, changing events) only happen on your explicit instruction
• You can revoke the connection at any time in your Google account settings

Troubleshooting

"Calendar not found"

• Ensure you have access to the calendar
• Use 'primary' for your main calendar
• Check the calendar ID in Google Calendar settings

"No emails found"

• Check your search criteria
• Ensure Gmail permissions were granted
• Use advanced search operators for more precise results

Authentication Errors

• Check your Google account settings
• Revoke and renew app permissions
• Ensure third-party apps are allowed

"This app hasn't been verified by Google" warning

This is expected behavior, not a security problem. meinGPT connects via a single, centrally-managed Google OAuth app that hasn't (yet) gone through Google's third-party app verification process. Click "Advanced" and then "Go to meinGPT (unsafe)" to proceed.