Google

Google (Gmail, Calendar, and Drive) is Town’s core integration. It’s required for your assistant to function.

What’s included

Gmail

Your assistant can:

Read and search emails — Access email content, search by sender, date, subject, and more
Manage labels — Create, add, and remove labels
Organize your inbox — Archive, trash, and move emails
Send and draft — Send emails to you and create drafts for your review
Access attachments — Download and process files attached to emails

Google Calendar

Your assistant can:

View your schedule — See upcoming events and check availability
Create meetings — Schedule events with attendees and Google Meet links
Edit events — Modify details or RSVP to invitations
Delete events — Cancel or remove events from your calendar

Google Drive

Your assistant can:

Read files — Access documents and spreadsheets
Create and update files — Write new content or modify existing documents
Search Drive — Find files across your Drive

Connecting Gmail

First-time setup

Sign up for Town
Click Connect Gmail Account
Select your Google account
Review and approve permissions
You’re connected!

Adding additional accounts

Go to Settings, then Accounts
Click Add Account
Sign in with the Google account you want to add
The new account is now available for your routines

What permissions are needed

Permission	Why it’s needed
Read email	Your assistant reads and analyzes your emails
Send email	Your assistant sends emails (with your approval when in approval-required mode)
Manage labels	Organize and filter your emails
Calendar access	View and manage your calendar events
Drive access	Read and write documents and files

Town uses secure sign-in (OAuth) — your password is never stored. You can revoke access anytime from your Google Account settings.

Email search tips

When your assistant searches your email, it understands natural language. In your routine instructions, you can describe what to search for:

What you want	How to describe it
Emails from someone	”emails from john@example.com”
Recent emails	”emails from the last 7 days”
Unread emails	”unread emails in my inbox”
Emails with attachments	”emails with attachments”
Specific subject	”emails with ‘meeting’ in the subject”
Starred emails	”starred emails”

You can combine these: “unread emails from john@example.com in the last 30 days with attachments.”

Multiple accounts

When you have multiple Gmail accounts connected:

Per-account triggers — You can configure routines to run on emails from a specific account or all accounts
Account context — When a routine runs, it uses the triggering account’s email, labels, calendar, and Drive

Managing accounts

In Settings, then Accounts:

View connected accounts — See all your Gmail accounts
Set primary — Choose the default account for new routines
Remove account — Disconnect an account
Re-authorize — Fix permission issues by signing in again

Disconnecting Google Drive or Contacts

Google Drive and Google Contacts aren’t separate integrations — they’re extra permissions on your connected Google account. You can turn either one off on its own, without removing the whole account (which would also disconnect Gmail and Calendar).

Go to Settings, then Accounts
Find the Google Drive or Google Contacts row under your Google account
Open the ⋮ menu next to its status and choose Disconnect, then confirm

Town stops using that access right away and turns off any assistant tools that depend on it. You can turn it back on anytime with Enable on the same row.

After you disconnect, Google’s own account permissions page may still list Town — Town simply stops using the access. To fully revoke it on Google’s side, remove Town from your Google Account settings .

Calendar safety note

If you’re the organizer of a calendar event, deleting it cancels the event for ALL attendees. If you’re just an attendee, it only removes the event from your calendar.

Troubleshooting

Work account blocked by your organization

If Google shows “Access blocked: Authorization Error” (Error 400: admin_policy_enforced) when you try to connect a work account, your organization’s Google Workspace settings restrict which third-party apps employees can authorize. The block comes from Google, not Town — ask your Workspace admin to allow Town for your organization, then connect again.

Send your admin the Google Workspace Authorization Guide — it has Town’s official app name and OAuth client ID, the exact scopes to allowlist, and fixes for common authorization errors.

Permission errors

If routines fail with permission errors:

Go to Settings, then Accounts
Click Re-authorize on the affected account
Complete the sign-in flow again

Missing emails

If routines aren’t finding emails:

Check which account the routine is using
Verify your search criteria are correct
Check if the emails are in trash or spam

Rate limits

Gmail has limits on how many operations can happen in a short period. If you see rate limit errors:

Reduce how often the routine triggers
Space out scheduled routines