Linear

Connect Linear to give your assistant access to issues, projects, teams, and workflow states.

What’s included

With Linear connected, your assistant can:

View issues — See issues across teams and projects
Get issue details — Access full issue information
Create issues — Open new issues with labels and assignments
Update issues — Modify existing issues
Add comments — Comment on issues
View teams and projects — Browse your workspace structure
Manage labels — List and create labels

Connecting Linear

Go to Integrations
Find Linear and click Connect
Authorize Town in Linear
Return to Town

Town requests read and write access to your Linear workspace. You can revoke access anytime from Linear’s settings.

What your assistant can do

Capability	What it does	Makes changes?
List issues	Find issues with filters	No
Get issue details	View a specific issue	No
Create issue	Create a new issue	Yes
Update issue	Modify an existing issue	Yes
Add comment	Comment on an issue	Yes
List teams	See available teams	No
List projects	View projects	No
Get project details	See project information	No
List workflow states	See issue statuses	No
List users	See team members	No
List labels	See available labels	No
Create label	Add a new label	Yes

Use cases

Email to issue

Create Linear issues from emails:

Forward bug reports to your assistant
Automatically create issues with email context
Include the full email thread in the issue description

Daily standup

Get a summary of your Linear activity:

Issues assigned to you
Recently updated issues
Blocked items needing attention

PR to issue linking

Connect GitHub activity to Linear issues:

When a PR is opened, find related issues
Track progress across both tools

Example workflow

A workflow that creates issues from forwarded emails:


When I forward an email to my assistant with "linear:" in the subject:
1. Extract the issue title from the subject (after "linear:")
2. Use the email body as the issue description
3. Create the issue in my default team
4. Reply with a link to the created issue

Best practices

Use approval-required for creating issues. Creating issues affects your team’s board. Review before creating.

Be specific about which team. When creating issues, specify the team to avoid confusion.

Include context. When creating issues from emails, include relevant email context in the description so your team has the full picture.