Linear
Linear project management — issues, projects, cycles, and teams
The Linear integration lets your agents manage issues, projects, cycles, and teams in Linear.
Prerequisites
You need one of the following:
- Linear API Key — Generate one at Linear Settings → API.
- OAuth — For user-level access where each chat user authorizes with their own Linear account.
Setup
- Open Integrations from the sidebar
- Select Linear from the catalog
- Click Add Integration Config
- Give the config a display name (e.g., "Linear - Engineering")
- Choose your authentication method:
- API Key — Paste your Linear API key
- OAuth — Click Connect to start the Linear OAuth flow
- Save the config
Using in Your Agent
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach Linear tools from the tools panel
- Tools are referenced as
linear.list_issues,linear.create_issue, etc.
Available Tools
| Tool | Description | Action Type |
|---|---|---|
get_viewer | Get the current authenticated user | ReadOnly |
list_teams | List teams | ReadOnly |
list_users | List workspace members; resolve a name or email to a user ID | ReadOnly |
list_issues | List issues, optionally filtered by assignee email, team, state, or project | ReadOnly |
get_issue | Get a specific issue by UUID or identifier (e.g. ENG-123) | ReadOnly |
search_issues | Full-text search issues | ReadOnly |
list_projects | List projects | ReadOnly |
list_labels | List labels | ReadOnly |
list_workflow_states | List workflow states | ReadOnly |
list_cycles | List cycles | ReadOnly |
create_issue | Create an issue (title, team, description, priority, assignee, state, project, labels, parent, estimate, cycle) | Reversible |
update_issue | Update an issue (any of the above fields, including re-parenting and cycle) | Reversible |
add_comment | Add a comment to an issue | Reversible |
archive_issue | Archive an issue (reversible soft-delete) | Reversible |
create_attachment | Attach an external link (PR, doc, dashboard) to an issue | Reversible |
create_project | Create a project under one or more teams | Reversible |
update_project | Update a project's name, description, or lead | Reversible |