Linear

Developer toolsby OpenAI

Manage issues, projects, and team workflows in Linear with natural language. Create and update issues, track progress, plan cycles, and coordinate development tasks using Linear’s streamlined project management interface for faster, more efficient workflows.

23ChatGPT Tools

22Claude Tools

OpenAIDeveloper

Developer toolsCategory

Use Cases

productivity

Available Tools

Add Comment To Issue

add_comment_to_issue

Full Description

Add a comment to a Linear issue.

Parameters (3 required)

Required

bodystring

issue_idstring

parent_idstring

Add Label To Issue

add_label_to_issue

Full Description

Attach a label to a Linear issue.

Parameters (2 required)

Required

issue_idstring

label_idstring

Add Url Attachment To Issue

add_url_attachment_to_issue

Full Description

Attach a URL as an attachment to a Linear issue.

Parameters (3 required)

Required

issue_idstring

titlestring

urlstring

Assign Issue

assign_issue

Full Description

Assign a Linear issue to a user.

Parameters (2 required)

Required

issue_idstring

user_idstring

Create Issue

create_issue

Full Description

Create a new issue in Linear.

Parameters (2 required, 7 optional)

Required

team_idstring

titlestring

Optional

assignee_idstring

Default: null

descriptionstring

Default: null

label_idsarray

Default: null

parent_idstring

Default: null

priorityinteger

Priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low

Default: null

project_idstring

Default: null

state_idstring

Default: null

Create Label

create_label

Full Description

Create a new label in Linear.

Parameters (1 required, 3 optional)

Required

label_namestring

Optional

colorstring

Default: null

descriptionstring

Default: null

team_idstring

Default: null

Create Project

create_project

Full Description

Create a new project in Linear.

Parameters (2 required, 1 optional)

Required

namestring

team_idstring

Optional

descriptionstring

Default: null

Fetch

fetch

Full Description

Fetches an Issue object by issue ID.

Parameters (1 required)

Required

issue_idstring

Get Initiatives

get_initiatives

Full Description

Retrieve initiatives configured in Linear.

Get Issue

get_issue

Full Description

Fetch a specific issue by its ID.

Parameters (1 required)

Required

issue_idstring

Get Issue Comments

get_issue_comments

Full Description

Return the comments attached to a Linear issue.

Parameters (1 required)

Required

issue_idstring

Get Issue Labels

get_issue_labels

Full Description

Return the labels attached to a Linear issue.

Parameters (1 required)

Required

issue_idstring

Get Label Id By Name

get_label_id_by_name

Full Description

Look up a Linear label ID by name.

Parameters (1 required, 1 optional)

Required

label_namestring

Optional

team_idstring

Default: null

Get Profile

get_profile

Full Description

Fetch the current authenticated user's profile.

Get Project

get_project

Full Description

Fetch a specific project by its ID.

Parameters (1 required)

Required

project_idstring

Get Project Id By Name

get_project_id_by_name

Full Description

Look up a Linear project ID by name.

Parameters (1 required)

Required

project_namestring

Get Project Updates

get_project_updates

Full Description

Return the last 20 updates for a project, including author, health, and content.

Parameters (1 required, 2 optional)

Required

project_idstring

Optional

page_cursorstring

Default: null

page_sizeinteger

Default: 20

Get Projects By Initiative

get_projects_by_initiative

Full Description

List Linear projects that belong to a given initiative.

Parameters (1 required)

Required

initiative_idstring

Get Projects By Team Id

get_projects_by_team_id

Full Description

Search projects for a given team ID. Optionally restrict to active (not completed) projects. Returns a page of matching projects and pagination info.

Parameters (1 required, 3 optional)

Required

team_idstring

Optional

active_onlyboolean

Default: False

page_cursorstring

Default: null

page_sizeinteger

Default: 50

Get State Id By Name

get_state_id_by_name

Full Description

Return the ID for a Linear state with the given name.

Parameters (2 required)

Required

state_namestring

team_idstring

Get Team Members

get_team_members

Full Description

List members of a Linear team.

Parameters (1 required)

Required

team_idstring

Get Team States

get_team_states

Full Description

Fetch workflow states for a Linear team.

Parameters (1 required)

Required

team_idstring

Get User By Email

get_user_by_email

Full Description

Find a Linear user by email address.

Parameters (1 required)

Required

emailstring

List Issues In Project

list_issues_in_project

Full Description

List issues belonging to a project. Optionally restrict to open issues only. Returns a page of issues and pagination info.

Parameters (1 required, 3 optional)

Required

project_idstring

Optional

open_onlyboolean

Default: False

page_cursorstring

Default: null

page_sizeinteger

Default: 50

List Recent Tickets

list_recent_tickets

Full Description

Return the most recently updated issues for the viewer's teams.

Parameters (0 required, 1 optional)

Optional

top_kinteger

Default: 20

Remove Label From Issue

remove_label_from_issue

Full Description

Remove a label from a Linear issue.

Parameters (2 required)

Required

issue_idstring

label_idstring

Resolve Comment

resolve_comment

Full Description

Mark a Linear comment as resolved.

Parameters (1 required, 1 optional)

Required

comment_idstring

Optional

resolving_comment_idstring

Default: null

Search

search

Full Description

Search Linear issues.

The `filters dictionary accepts the following keys: user_id (call get_profile to obtain the ID of the current user), assigned_to_me (boolean), assignee_name, assignee_id, creator_name, creator_id, project_name, project_id, priority(integer), team_id, team_name, state_id, state_name, and date fields: createdAt,updatedAt, completedAt, startedAt using [op, value] where op is one of eq, neq, lt, lte, gt, gte. Example: {"user_id": "usr_123", "project_name": "Backend", "createdAt": ["gte", "2025-01-01"]}. query is a free-text search query. recency_days is ignored. topn is the number of results to return. If query` is empty, the most recently updated issues are returned.

Parameters (1 required, 4 optional)

Required

querystring

Optional

connector_scopesobject

Default: null

filtersobject

Default: null

recency_daysinteger

Default: null

topninteger

Default: 20

Search Issues

search_issues

Full Description

Search issues by free-text query against title/description. Optionally restrict to open issues only. Returns a page of matching issues and pagination info. If `query is empty, the most recently updated issues are returned.

DO NOT USE THIS WITH call_api. For comprehensive filterable search use search` instead.

Parameters (1 required, 3 optional)

Required

querystring

Optional

open_onlyboolean

Default: False

page_cursorstring

Default: null

page_sizeinteger

Default: 50

Search Issues Generic Filter

search_issues_generic_filter

Full Description

Search Linear issues using a raw GraphQL filter.

Parameters (1 required, 2 optional)

Required

issue_filter

Optional

page_cursorstring

Default: null

page_sizeinteger

Default: 50

Search Projects

search_projects

Full Description

Search projects by name substring. Optionally restrict to active (not completed) projects. Returns a page of matching projects and pagination info.

Parameters (1 required, 3 optional)

Required

querystring

Optional

active_onlyboolean

Default: False

page_cursorstring

Default: null

page_sizeinteger

Default: 50

Search Teams

search_teams

Full Description

Search for Linear teams using a filter.

Parameters (1 required)

Required

filter

Set Issue State

set_issue_state

Full Description

Move a Linear issue to a different state.

Parameters (2 required)

Required

issue_idstring

state_idstring

Unassign Issue

unassign_issue

Full Description

Remove the assignee from a Linear issue.

Parameters (1 required)

Required

issue_idstring

Update Issue

update_issue

Full Description

Update fields on a Linear issue.

Parameters (2 required)

Required

issue_idstring

issue_update

Update Project

update_project

Full Description

Update properties on a Linear project.

Parameters (2 required)

Required

project_idstring

update_fields

Links

Website Privacy Policy