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 your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select Linear from the integration list
- 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 agent revision
Using in Your Agent
- In an Agent Step, attach Linear tools from the tools panel
- The agent uses your integration config for all Linear API calls
- 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_issues | List issues | ReadOnly |
get_issue | Get a specific issue | ReadOnly |
search_issues | 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 | Reversible |
update_issue | Update an issue | Reversible |
add_comment | Add a comment to an issue | Irreversible |