Tools – Town Docs
Tools
Tools are the actions your assistant can take within a routine. Each routine only has access to the tools you choose to enable — this keeps your assistant focused and in control.
Your assistant can manage your inbox with these capabilities:
| Capability | What it does | Makes changes? |
|---|---|---|
| Read emails | Read the full content of a specific email | No |
| Search emails | Find emails using search queries (sender, subject, date, etc.) | No |
| Smart search | AI-enhanced search that summarizes and filters results | No |
| Add label | Apply a label to an email | Yes |
| Remove label | Remove a label from an email | Yes |
| Archive | Move an email out of your inbox (still searchable) | Yes |
| Trash | Move an email to trash | Yes |
| Move | Move an email to a specific folder or label | Yes |
| Create draft | Write a draft email in your Gmail | Yes |
| Send email to you | Send an email directly to your inbox | Yes |
| List labels | See all available Gmail labels | No |
| View attachments | List and access email attachments | No |
Tools marked “Makes changes” are considered write actions. In approval-required mode, these wait for your approval before executing.
Email search tips
Your assistant uses standard Gmail search when looking for emails. Some useful patterns:
| Search for | How to describe it |
|---|---|
| Emails from someone | ”emails from john@example.com” |
| Emails with a subject | ”emails with ‘meeting’ in the subject” |
| Recent emails | ”emails from the last 7 days” |
| Unread emails | ”unread emails” |
| Emails with attachments | ”emails with attachments” |
| Emails in inbox | ”emails in my inbox” |
Calendar
Full access to your Google Calendar:
| Capability | What it does | Makes changes? |
|---|---|---|
| List events | Get events within a time range | No |
| Get event details | See full details of a specific event | No |
| Create event | Create a new event with attendees, reminders, and Google Meet | Yes |
| Edit event | Change event details or update your RSVP | Yes |
| Delete event | Remove an event from your calendar | Yes |
If you’re the organizer of an event, deleting it cancels the event for all attendees. If you’re just an attendee, it only removes the event from your calendar.
Research
Tools for searching the web and running calculations:
| Capability | What it does |
|---|---|
| Web search | Search the web and get AI-analyzed results |
| Run calculations | Execute code for math, data processing, and analysis |
The calculation tool is useful for processing attachments (like spreadsheets), generating reports, and doing any computation your routine needs.
Documents and content
Tools for working with your Town documents and content library:
| Capability | What it does | Makes changes? |
|---|---|---|
| Browse content | Explore your content library | No |
| Search content | Find items across your content | No |
| Manage collections | Organize content into collections | Yes |
| Create documents | Create new documents | Yes |
| Edit documents | Insert, replace, delete, and format text | Yes |
| List documents | View your documents | No |
Vision and media
| Capability | What it does |
|---|---|
| View images | Analyze and understand images |
| Generate images | Create images from descriptions |
| Process audio | Work with audio recordings and transcripts |
Analytics
| Capability | What it does |
|---|---|
| View analytics | See usage and performance data |
| Analytics summary | Get a formatted overview of your analytics |
Routine management
Tools that let routines interact with other routines:
| Capability | What it does |
|---|---|
| Query history | Search what other routines have done |
| History summary | Get an AI summary of recent routine activity |
| List routines | See all your routines |
| View run history | See recent runs for any routine |
These are especially useful for summary and reporting routines that need to know what your other routines have been doing.
Memory
| Capability | What it does | Makes changes? |
|---|---|---|
| Read memories | Access stored preferences and facts | No |
| Add memory | Store a new preference or fact | Yes |
| Remove memory | Delete a stored memory | Yes |
Integration tools
These tools become available when you connect external services in Settings > Integrations.
GitHub
| Capability | What it does |
|---|---|
| List repositories | See your accessible repos |
| Read files | View files from a repository |
| Create or update files | Make changes to repo files |
| List commits | See recent changes |
| List pull requests | View open and closed PRs |
| Create pull request | Open a new PR |
| View PR comments | Read comments on pull requests |
| View issue comments | Read comments on issues |
Slack
| Capability | What it does |
|---|---|
| Send direct message | Message a specific user |
| Send channel message | Post to a Slack channel |
| Send group message | Message multiple users |
| List channels | See available channels |
| List users | See workspace members |
| Search messages | Find messages across Slack |
| Get thread | Read a full message thread |
Linear
| Capability | What it does |
|---|---|
| List issues | Find issues with filters |
| Get issue details | View a specific issue |
| Create issue | Create a new issue |
| Update issue | Modify an existing issue |
| Add comment | Comment on an issue |
| List teams | See available teams |
| List projects | View projects |
| List labels | See available labels |
| Create label | Add a new label |
Notion
| Capability | What it does |
|---|---|
| Search | Find pages and databases |
| Query database | Search a database with filters |
| Get page | View page content |
| Create page | Create a new page |
| Create database entry | Add a row to a database |
| Update page | Modify page content |
| Update database entry | Edit a database row |
| Add content | Append blocks to a page |
HubSpot
| Capability | What it does |
|---|---|
| List contacts | View your contacts |
| Get contact | See contact details |
| Create contact | Add a new contact |
| Update contact | Modify contact properties |
| List deals | View your deals |
| Get deal | See deal details |
Dropbox
| Capability | What it does |
|---|---|
| List files | Browse files and folders |
| Get file info | View file metadata |
| Download file | Access file contents |
| Upload file | Add or replace a file |
| Search files | Find files by name or content |
| Create folder | Make a new folder |
| Create shared link | Generate a shareable link |
| List shared links | View existing shared links |
Asana
| Capability | What it does |
|---|---|
| List workspaces | See your Asana workspaces |
| List projects | View projects in a workspace |
| Get project | See project details |
| List tasks | Find tasks with filters |
| Get task | View task details |
| Create task | Add a new task |
| Update task | Modify a task |
| Add comment | Comment on a task |
Integration tools only appear when you’ve connected the corresponding service in Settings > Integrations.
Smart vs. standard tools
Some tools have “smart” variants that use AI to filter and summarize results before returning them. This is useful when you need the key information rather than raw data.
- Standard search returns all matching results
- Smart search returns a filtered, summarized version
Use smart tools when you’re doing research or need a quick overview. Use standard tools when you need exact, complete data.
Tips for choosing tools
Only enable what’s needed. Each routine should have just the tools it actually uses. Fewer tools helps your assistant stay focused.
Start with read-only tools. When building a new routine, start with tools that only read data. Add tools that make changes after you’ve tested the behavior.
Use “send email to you” for notifications. This tool sends emails to your own inbox — a great way for routines to report back to you.
Per-tool mode overrides
You can set individual tools to require approval even when the routine’s default mode is autonomous. For example, you might want a routine that automatically labels and archives emails (autonomous) but requires your approval before sending any emails.
This is configured in the routine settings.