Connect Linear to Your AI Agent

Ask AI to investigate related reports, write an actionable issue, or apply a specific backlog update.

34 tools OAuth / API key

Try a Linear Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Linear

Investigate Related Reports

Search for related issues and compare their descriptions and comments to identify common symptoms.

/oo Linear: Search Linear for [symptom or topic], read matching issues and comments, and summarize common symptoms, differences, and missing reproduction details.

Turn a Report into an Issue

Let AI organize a report into a clear title, context, and reproduction steps before creating it in your team.

/oo Linear: Create a Linear issue in team [team ID] from this report: [report]. Include context, reproduction steps, and expected behavior; identify missing details.

Clarify an Existing Issue

Read an issue and let AI incorporate your new findings into its description.

/oo Linear: Read Linear issue [issue ID], incorporate these findings into its description without dropping existing details, and update it: [findings].

Post a clear investigation update

Give teammates the confirmed findings and the next question to resolve.

/oo Linear: Post these investigation notes as a comment on Linear issue [issue ID]: [notes]. Keep the findings and next steps easy to scan.

Start Working with Linear

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Linear

    Connect through Linear OAuth or a personal API key.

    Connect Linear →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • A Linear account and access to the target teams and issues.
  • Issue access and changes depend on the permissions of your connection.

Linear Tools

Connect Linear issues and their discussions to your AI assistant for analysis and supported issue operations.

Search and Read Issues

Search issue text and retrieve issue details and comments.

Create and Update Issues

Create team issues and update descriptions, status, assignment, and other issue details.

Read Project Context

List projects and retrieve project details to put issue work in context.

34 tools

Create Attachment

Create or update an attachment for the specified Linear issue.

linear.create_attachment

Create Comment Reaction

Creates an emoji reaction for the specified Linear comment.

linear.create_comment_reaction

Create Linear Comment

Creates a comment for the specified Linear issue.

linear.create_linear_comment

Create Linear Issue

Create a new Linear issue in the specified team and support fields such as project, person in charge, status, label, etc.

linear.create_linear_issue

Create Linear Issue Relation

Create a relationship between two Linear issues, such as blocks, related, or duplicate.

linear.create_linear_issue_relation

Create Linear Label

Creates a new Linear issue label in the specified team.

linear.create_linear_label

Create Linear Project

Create a new Linear project and associate one or more teams.

linear.create_linear_project

Create Project Milestone

Creates a project milestone for the specified Linear project.

linear.create_project_milestone

Create Project Update

Creates a project progress update for the specified Linear project.

linear.create_project_update

Delete Linear Issue

Delete the specified Linear issue.

linear.delete_linear_issue

Get All Linear Teams

Lists all Linear team basic information accessible with the current credentials.

linear.get_all_linear_teams

Get Attachment

Retrieve a Linear attachment based on the issue and attachment ID or file name.

linear.get_attachment

Get Current User

Get the currently authenticated Linear user profile.

linear.get_current_user

Get Cycles By Team Id

Get all cycle information under the specified team.

linear.get_cycles_by_team_id

Get Issue Defaults

Gets the default status and default estimate used when the specified team creates an issue.

linear.get_issue_defaults

Get Linear Issue

Get details of a Linear issue, including comments, attachments, subscribers, and underlying relationship fields.

linear.get_linear_issue

Get Linear Project

Get the details of a Linear project, complete with team, members, and initiatives on demand.

linear.get_linear_project

List Issues By Team Id

List Linear issues by team, and support cursor paging and whether to include archived issues.

linear.list_issues_by_team_id

List Issue Drafts

Lists issue drafts visible to the current user in Linear.

linear.list_issue_drafts

List Linear Cycles

Lists the Linear periods accessible by the current credential.

linear.list_linear_cycles

List Linear Issues

Lists Linear issues accessible with current credentials, and supports filtering by project and person in charge.

linear.list_linear_issues

List Linear Labels

Lists Linear labels for a specified team or entire workspace.

linear.list_linear_labels

List Linear Projects

Lists Linear projects accessible with the current credentials.

linear.list_linear_projects

List Linear States

Lists all workflow statuses for the specified team.

linear.list_linear_states

List Linear Teams

Lists Linear teams accessible with current credentials, along with a list of members and projects.

linear.list_linear_teams

List Linear Users

List Linear users in the current workspace and support cursor paging.

linear.list_linear_users

Remove Issue Label

Removes a label from the specified Linear issue.

linear.remove_issue_label

Remove Reaction

Delete an existing Linear reaction.

linear.remove_reaction

Run Query

Execute a read-only query directly against the Linear GraphQL API.

linear.run_query

Run Mutation

Perform a mutation directly on the Linear GraphQL API.

linear.run_mutation

Search Issues

Retrieve issues through Linear's full-text search capabilities.

linear.search_issues

Update Issue

Update an existing Linear issue and support fields such as title, description, status, project, label, etc.

linear.update_issue

Update Linear Comment

Update the text of an existing Linear comment.

linear.update_linear_comment

Update Linear Project

Update an existing Linear project.

linear.update_linear_project

Work Across Apps

Share issue context in Slack

Bring an issue’s findings and open questions into the team conversation.

Frequently Asked Questions

Can AI help investigate possible duplicate issues?

Yes. Provide symptoms or keywords and ask for a comparison of matching issues. Treat the result as a shortlist to review before changing issue relationships.

Can I update an issue using new investigation notes?

Yes. Provide the issue ID and the new findings. Specify whether the assistant should revise the description or add a comment.

Do I need a personal API key?

You can connect through OAuth or use a personal API key.

Will a new issue be saved as a draft?

The create-issue operation creates an issue in the specified team. Ask the assistant to prepare text in your conversation if you want to review it before creation.

Connect Linear

About Linear ↗