Linear Integration

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

What’s included

With Linear connected, your assistant can:

List issues — See issues across teams and projects
Get issue details — Access specific issue information
Create issues — Open new issues with labels and assignments
List teams — See available teams
List workflow states — Understand issue statuses

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.

Linear tools

Once connected, these tools become available:

Tool	Description	Write?
`linear_list_issues`	List issues with filters	No
`linear_get_issue`	Get specific issue details	No
`linear_create_issue`	Create a new issue	Yes
`linear_list_teams`	List available teams	No
`linear_list_workflow_states`	List workflow states	No

Use cases

Email-to-issue

Create Linear issues from emails:

Forward bug reports to your assistant
Automatically create issues with context
Include email thread as 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 PRs to Linear issues:

When a PR is opened, find related issues
Update issue status based on PR state

Example: Create issue from email

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 email 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

Configuration

Workspace access

Town connects to the Linear workspace you authorize. All teams and projects in that workspace are accessible.

Permissions

Town requests:

Read access — View issues, teams, projects, states
Write access — Create issues and comments

Best practices

Use approval-required for creates. Creating issues affects your team. Review before creating.

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

Include context. When creating issues from emails, include relevant email context in the description.