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 workflows
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 workflow 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 workflows to run on emails from a specific account or all accounts
- Account context — When a workflow 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 workflows
- Remove account — Disconnect an account
- Re-authorize — Fix permission issues by signing in again
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
Permission errors
If workflows 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 workflows aren’t finding emails:
- Check which account the workflow 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 workflow triggers
- Space out scheduled workflows