Skip to main content
Connect Linear so agents can create issues, update status as they work, and link code changes to tickets.

​
What agents can do with Linear

Once connected, agents can:
  • Create issues from context: Find a bug? The agent creates an issue with steps to reproduce, relevant code snippets, and suggested labels.
  • Update as they work: Agents can move issues to “In Progress” when they start and “Done” when they finish.
  • Search and reference: Ask about related issues, find duplicates, or get context from existing tickets.
  • Add comments: Document findings, link PRs, or note blockers directly in Linear.

​
Start a session from an issue

Beyond the MCP tools above, you can start an Ona agent session directly from a Linear issue in two ways:
  • Mention the agent in an issue comment to start a session on that issue.
  • Delegate the issue to Ona by assigning it, and the agent picks it up.
The agent reads the issue for context, works in the matching Ona environment, and posts its progress back on the issue. The session runs under your identity, so it uses your organization role and project permissions. When someone assigns an issue to Ona on another person’s behalf, the session runs as the issue’s assignee. This requires the agent app authorization from Step 1 to be active. If it is not, see the “Agent features are not active” note under Troubleshooting.

​
Example workflows

"Create a Linear issue for this authentication bug with the stack trace"

"Show me all high-priority issues assigned to me in the API project"

"Move issue ABC-123 to In Progress and add a comment that I'm starting work"

"Find any existing issues about rate limiting before I create a new one"

​
Connect Linear

​
Step 1: Organization setup

An admin needs to enable Linear for your organization first.
  1. Go to Organization Settings > Integrations
  2. Find Linear and click Enable
  3. Configure default workspace settings if needed
Enable Linear in organization settings

​
Step 2: Authenticate your account

Once enabled, connect your personal Linear account:
  1. Go to User Settings > Integrations
  2. Click Connect next to Linear
  3. Authorize Ona to access your Linear workspace
  4. Select which workspaces to connect
Connect your Linear account

​
Verify it works

Start a session with an agent and try: 
Show me my open Linear issues
If you see your issues, you’re connected. If not, verify both organization enablement and your personal authentication are complete.

​
Tips for effective use

Be specific about projects: If you have multiple Linear teams, specify which one: “Create an issue in the API team for this bug.” Include context: The more context you give, the better the issue: “Create an issue for this null pointer exception, include the stack trace and the user flow that triggers it.” Use with AGENTS.md: Add your Linear conventions to AGENTS.md so agents know your labeling system and workflow stages.

​
Next steps

​
Troubleshooting

This warning means the app authorization for agent capabilities (like @mentions and webhooks) is missing or expired. Basic features like reading and creating issues via MCP tools still work with your personal token.Click Authorize app to start the authorization flow.
Linear allows only one app installation per workspace. If another Ona organization has already authorized the app on the same Linear workspace, the authorization flow will show that the app is already installed instead of issuing a new token.To resolve this:
  1. In Linear, go to Settings > Integrations > Ona and remove the existing installation
  2. Return to Ona and click Authorize app to re-install for the correct organization
Only one Ona organization can have agent features (webhooks, @mentions) active per Linear workspace at a time. Other Ona organizations connected to the same workspace can still use MCP tools (read/write issues) through personal authentication.