Linear
For fast-moving product teams who need instant issue and cycle visibility without breaking their workflow.
6 min read
Updated February 2026
Overview
Product and engineering teams living in Linear still get pulled into Slack threads and meetings just to answer “Where are we on that feature?” or “Is LIN-384 done yet?” Every context switch costs minutes that compound across a sprint.
The Linear integration gives your AI agent direct read access to issues, projects, and cycles. Anyone on the team—or even a customer-facing bot—can ask a question and get a live answer pulled straight from Linear.
When to Enable This
- Non-engineering teammates regularly ask for issue updates in Slack or meetings
- Your support team needs to check whether a customer-reported bug has been fixed
- Leadership wants a self-serve way to check cycle or project progress
Available Actions
| Action | Description |
|---|---|
| Get Issue | Retrieve full details for a specific issue by identifier (e.g., LIN-384) |
| Search Issues | Find issues by keyword, assignee, label, or status |
| Project Progress | Get completion percentage, milestone status, and blockers for a project |
| Cycle Status | Summarize the active cycle: scope, completed items, and burndown |
Prerequisites
- A Linear workspace
- Admin or member access to generate a personal API key
Setup Instructions
Step 1: Generate a Linear API Key
- In Linear, go to Settings → API
- Click Create key
- Give it a label like “ChatSpark”
- Copy the key immediately—it's only shown once
Step 2: Enable in ChatSpark
- In ChatSpark, go to AI Actions
- Find Linear in the Library and click Enable
- Select the agent(s) that should have access
- Paste your API key
- Click Save
Configuration Fields
| Field | Description | Example |
|---|---|---|
| API Key | Your Linear personal API key | lin_api_... |
Testing Your Integration
After setup, open your AI agent and try these realistic queries:
- “What's the status of LIN-384?”
- “Show me open bugs assigned to me”
- “How's the Onboarding Revamp project going?”
- “What's left in the current cycle?”
Troubleshooting
401 Unauthorized
Verify that the API key hasn't been revoked. In Linear, go to Settings → API and confirm the key is still active.
Issues not found
The API key can only access teams and projects visible to the account that created it. If an issue belongs to a private team, the key owner must be a member of that team.
Cycle data empty
Cycle Status requires at least one active cycle in the target team. If cycles aren't enabled for a team, this action won't return results.