Google Workspace

The Google Workspace app connects Gmail, Google Calendar, Google Sheets, Google Docs, and Google Drive to Sprigr Team in a single install. It replaces the older built-in Gmail, Google Calendar, Google Sheets, Google Docs, and Google Drive integrations, which are no longer offered for new connections.

Prerequisites

A Google account. Google Workspace and personal Google accounts are both supported.
Admin or Owner role to install the app for your company. Any member can connect their own Google account once the app is installed.
If your Google Workspace admin restricts third-party apps, they may need to approve Sprigr in the Google Admin console before the consent screen will complete.

Installing and connecting

Install the app

Sign in to team.sprigr.com, open Apps in the sidebar, find Google Workspace under Available, and install it. See Installing Apps.
Connect your Google account

Open the app’s settings page from Apps > Installed and choose Connect, or ask your agent to connect Google for you. The agent calls gws_connect and sends you a Google sign-in link. Each person who wants their agent to use Google does this once with their own account.
Grant the requested scopes

Review the permissions on the Google consent screen and click Allow. The app requests Gmail send and modify, Contacts read, and the Calendar, Sheets, Docs, and Drive scopes it needs. Users who connected before the Calendar, Sheets, Docs, and Drive tools were added reconnect once to grant the added scopes; existing Gmail access is kept.
Check the connection

Ask your agent “Is my Google account connected?” It calls gws_connection_status and reports the connected mailbox, granted scopes, and connect time. To remove a connection, use gws_disconnect or the app settings page.

Mail sync, backfill, and the inbox

Once a user connects, the app can mirror that user’s Gmail into the Sprigr Inbox so agents and teammates work from the same threads:

Near-real-time sync. New mail arrives through Gmail push notifications with a scheduled poll as a backstop (gws_enable_mail_sync, gws_disable_mail_sync, gws_sync_status).
Historic backfill. gws_backfill_mailbox pulls older messages into the inbox; gws_backfill_status reports progress.
Sent folder mirroring. Mail sent from Sprigr appears in a Sent folder that lines up with your Gmail Sent mail.
Read state and folders mirror in both directions, so marking a thread read or moving it in Sprigr is reflected in Gmail.
File indexing. gws_enable_file_indexing indexes the user’s Drive files into a search index that agents can query; gws_disable_file_indexing turns it off.
Events for workflows. Synced mail and indexed files emit google.mail.received, google.mail.sent, google.file.created, google.file.updated and google.file.deleted, which a workflow can subscribe to.

Attachments on incoming mail are stored so agents can read them; the inbox search covers attachment text as well as message bodies.

Limits

Email attachments: up to 50 MB per attachment.
Drive file reads and downloads: up to 250 MB per file. Large text files are read in pages rather than cut off.

Available tools

All tools run as the calling user. A user who has not connected gets a not_connected result rather than another person’s data; the agent will offer a connect link.

Gmail

Tool	Description
`gmail_search`	Search mail with Gmail query syntax (sender, subject, keywords, date range, labels)
`gmail_read`	Read a full message by ID, including headers, body, and attachment metadata
`gmail_send`	Send a new message or a reply, with HTML body, CC, BCC, and file attachments (Sprigr files or Drive files; native Docs attach as PDF)
`gmail_download_attachment`	Fetch an attachment into Sprigr storage and return a link
`gmail_contacts_search`	Resolve names to addresses through Google Contacts and “Other contacts”
`gmail_delete`	Move a message to trash

There is no label-management tool. Agents can filter searches by existing labels but cannot create or apply them.

Google Calendar

Tool	Description
`calendar_list_events`	List events within a date range
`calendar_check_availability`	Check whether a time slot is free or busy
`calendar_create_event`	Create an event with attendees, time, and location, checking for conflicts first
`calendar_update_event`	Update or reschedule an event
`calendar_cancel_event`	Cancel an event

Google Sheets

Tool	Description
`sheets_list_spreadsheets`	List spreadsheets the user can access
`sheets_search`	Search within a spreadsheet
`sheets_read_range`	Read values from a range
`sheets_update_range`	Update values in a range
`sheets_append_row`	Append a row
`sheets_create_spreadsheet`	Create a new spreadsheet

Google Docs

Tool	Description
`docs_create_from_template`	Copy a template document and replace `{{placeholder}}` markers with values
`docs_read`	Read the plain text of a document by ID
`docs_export_pdf`	Export a document as PDF and return a download link

Placeholder replacement is exact-match and case-sensitive. Use distinctive markers such as {{customerName}}.

Google Drive

Tool	Description
`drive_list_files`	List files and folders, optionally within a folder
`drive_search_files`	Search by name, type, or other criteria
`drive_read_file`	Read a file. Docs export as plain text, Sheets as CSV, Slides as plain text; binary files return metadata and a link
`drive_upload_file`	Upload a file to a folder
`drive_create_folder`	Create a folder
`drive_move_file`	Move a file between folders
`drive_delete_file`	Trash a file
`google_drive_create_document`	Create a real Word or Excel file (.docx or .xlsx) in Drive through the platform document engine
`google_drive_edit_document`	Make targeted edits to an existing .docx or .xlsx file in Drive
`google_drive_get_document_job`	Check the status of a document create or edit job

Connection and sync tools

Tool	Description
`gws_connect`	Mint a Google sign-in link for the calling user
`gws_connection_status`	Report the calling user’s connected mailbox and scopes
`gws_disconnect`	Revoke the calling user’s Google grant
`gws_enable_mail_sync` / `gws_disable_mail_sync` / `gws_sync_status`	Control inbox mirroring for the calling user
`gws_backfill_mailbox` / `gws_backfill_status`	Pull historic mail into the inbox
`gws_enable_file_indexing` / `gws_disable_file_indexing`	Control Drive file indexing

Common use cases

Inbox triage. An agent reads new mail in the shared inbox, files it by folder rules, drafts replies for you to review, and flags anything that needs a decision.
Scheduling. “Am I free Tuesday afternoon?” The agent checks the calendar and books the slot you choose.
Quotes and letters from templates. The agent copies a Docs template, fills in the values, exports a PDF, and attaches it to a draft email.
Logging to a sheet. A workflow appends a row to a tracking sheet each time a job or enquiry comes in.
Report distribution. A scheduled workflow emails a weekly summary to a distribution list.

Troubleshooting

“not_connected” from a Google tool The calling user has not linked a Google account. Ask the agent to connect Google, or open the app settings page and choose Connect.

“Access denied” on the consent screen Your Google Workspace admin may need to approve Sprigr as a trusted application in the Google Admin console.

Calendar, Sheets, Docs, or Drive tools fail but Gmail works The user connected before those scopes were added. Reconnect once to grant them.

Agent cannot find a file or spreadsheet The connected account must have access to it. Shared Drive files require the account to be a member of that Shared Drive.

Next steps

Microsoft 365: The equivalent app for Outlook, Teams, OneDrive, and SharePoint.
Inbox: Work synced mail alongside your team.
Installing Apps: How the Apps page works.
Workflows: Use Google tools as steps in automated workflows.