Linear (Legacy)

Developer toolsby OpenAI

Use your Linear issues and comments to create clear status updates, identify themes in recent work, or understand progress on a feature. Summarize new or resolved issues, review what’s still open, and prepare team updates grounded in the latest activity across your engineering workflow. Attachments aren’t included.

38ChatGPT Tools

OpenAIDeveloper

Developer toolsCategory

Available Tools

Add Comment To Issue

add_comment_to_issue

Full Description

Add a comment to a Linear issue.

Parameters (2 required, 1 optional)

Required

bodystring

Comment body to post to the issue.

issue_idstring

Linear issue ID to comment on.

Optional

parent_idstring

Optional parent comment ID when replying in a thread.

Default: null

Add Label To Issue

add_label_to_issue

Full Description

Attach a label to a Linear issue.

Parameters (2 required)

Required

issue_idstring

Linear issue ID to update.

label_idstring

Linear label ID to attach.

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

Linear issue ID to attach the URL to.

titlestring

Display title for the attachment.

urlstring

URL to attach to the issue.

Assign Issue

assign_issue

Full Description

Assign a Linear issue to a user.

Parameters (2 required)

Required

issue_idstring

Linear issue ID to update.

user_idstring

Linear user ID to assign.

Create Issue

create_issue

Full Description

Create a new issue in Linear.

Parameters (2 required, 7 optional)

Required

team_idstring

Linear team ID that should own the issue.

titlestring

Issue title.

Optional

assignee_idstring

Optional Linear user ID to assign.

Default: null

descriptionstring

Optional issue description.

Default: null

label_idsarray

Optional label IDs to attach.

Default: null

parent_idstring

Optional parent issue ID for a sub-issue.

Default: null

priorityinteger

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

Default: null

project_idstring

Optional Linear project ID to link.

Default: null

state_idstring

Optional Linear workflow state ID.

Default: null

Create Label

create_label

Full Description

Create a new label in Linear.

Parameters (1 required, 3 optional)

Required

label_namestring

Name for the new Linear label.

Optional

colorstring

Optional Linear label color.

Default: null

descriptionstring

Optional description for the label.

Default: null

team_idstring

Optional Linear team ID that should own the label.

Default: null

Create Project

create_project

Full Description

Create a new project in Linear.

Parameters (2 required, 1 optional)

Required

namestring

Name for the new Linear project.

team_idstring

Linear team ID that should own the project.

Optional

descriptionstring

Optional project description.

Default: null

Fetch

fetch

Full Description

Fetches an Issue object by issue ID.

Parameters (1 required)

Required

issue_idstring

Linear issue ID or issue identifier to fetch.

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

Linear issue ID to fetch.

Get Issue Comments

get_issue_comments

Full Description

Return the comments attached to a Linear issue.

Parameters (1 required)

Required

issue_idstring

Linear issue ID to inspect.

Get Issue Labels

get_issue_labels

Full Description

Return the labels attached to a Linear issue.

Parameters (1 required)

Required

issue_idstring

Linear issue ID to inspect.

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

Linear label name to resolve.

Optional

team_idstring

Optional Linear team ID to prefer first.

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

Linear project ID to fetch.

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

Linear project name to resolve.

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

Linear project ID to inspect.

Optional

page_cursorstring

Pagination cursor from a previous result page.

Default: null

page_sizeinteger

Maximum number of project updates to return.

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

Linear initiative ID to inspect.

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

Linear team ID to inspect.

Optional

active_onlyboolean

Whether to restrict results to active projects only.

Default: False

page_cursorstring

Pagination cursor from a previous result page.

Default: null

page_sizeinteger

Maximum number of projects to return.

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

Workflow state name to resolve.

team_idstring

Linear team ID to inspect.

Get Team Members

get_team_members

Full Description

List members of a Linear team.

Parameters (1 required)

Required

team_idstring

Linear team ID to inspect.

Get Team States

get_team_states

Full Description

Fetch workflow states for a Linear team.

Parameters (1 required)

Required

team_idstring

Linear team ID to inspect.

Get User By Email

get_user_by_email

Full Description

Find a Linear user by email address.

Parameters (1 required)

Required

emailstring

Email address to resolve.

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

Linear project ID to inspect.

Optional

open_onlyboolean

Whether to restrict results to open issues only.

Default: False

page_cursorstring

Pagination cursor from a previous result page.

Default: null

page_sizeinteger

Maximum number of issues to return.

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

Maximum number of issues to return.

Default: 20

Oai User Fetch

oai_user_fetch

Full Description

Uses mfetch to perform document fetch for link following and citations.

Parameters (2 required)

Required

content_locationstring

Content location returned by oai_user_search.

document_idstring

Document id returned by oai_user_search.

Oai User Search

oai_user_search

Full Description

Uses synced RAG index to perform semantic search against query. The index is refreshed until (now - 2h).

Parameters (1 required)

Required

querystring

Semantic search query for the synced knowledge store.

Remove Label From Issue

remove_label_from_issue

Full Description

Remove a label from a Linear issue.

Parameters (2 required)

Required

issue_idstring

Linear issue ID to update.

label_idstring

Linear label ID to remove.

Resolve Comment

resolve_comment

Full Description

Mark a Linear comment as resolved.

Parameters (1 required, 1 optional)

Required

comment_idstring

Linear comment ID to mark as resolved.

Optional

resolving_comment_idstring

Optional resolving comment ID recorded by Linear.

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

Free-text search query used to match issues, projects, and teams.

Optional

connector_scopesobject

Optional Linear scope hints encoded as canonical_handle -> display_name mappings.

Default: null

filtersobject

Structured Linear filters such as assignee, creator, project, team, state, priority, and date comparators.

Default: null

recency_daysinteger

Unused compatibility parameter. Linear search ignores recency hints.

Default: null

topninteger

Maximum number of issues to return.

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

Free-text issue search query.

Optional

open_onlyboolean

Whether to restrict results to open issues only.

Default: False

page_cursorstring

Pagination cursor from a previous result page.

Default: null

page_sizeinteger

Maximum number of issues to return.

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_filterobject

Raw Linear GraphQL filter object to apply. For supported fields and comparator semantics, see Linear's GraphQL docs at https://studio.apollographql.com/public/Linear-API/variant/current/schema/reference/inputs/IssueFilter and https://linear.app/developers/filtering. Typical shape: nested objects such as {'title': {'containsIgnoreCase': 'bug'}}, {'team': {'key': {'eq': 'ENG'}}}, {'project': {'id': {'eq': '<project-id>'}}}, {'state': {'name': {'eq': 'In Progress'}}}, {'completedAt': {'null': True}}, or {'and': [{'priority': {'lte': 2}}, {'assignee': {'email': {'eq': 'alice@example.com'}}}]}. Common top-level fields include title, description, team, project, state, labels, assignee, creator, priority, estimate, createdAt, updatedAt, startedAt, completedAt, and, or, parent, and children. This filter is passed through directly to Linear, so unsupported keys or invalid comparators will be rejected by Linear.

Optional

page_cursorstring

Pagination cursor from a previous result page.

Default: null

page_sizeinteger

Maximum number of issues to return.

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

Free-text project search query.

Optional

active_onlyboolean

Whether to restrict results to active projects only.

Default: False

page_cursorstring

Pagination cursor from a previous result page.

Default: null

page_sizeinteger

Maximum number of projects to return.

Default: 50

Search Teams

search_teams

Full Description

Search for Linear teams using a filter.

Parameters (1 required)

Required

filterobject

Raw Linear GraphQL team filter.

Set Issue State

set_issue_state

Full Description

Move a Linear issue to a different state.

Parameters (2 required)

Required

issue_idstring

Linear issue ID to update.

state_idstring

Linear workflow state ID to apply.

Unassign Issue

unassign_issue

Full Description

Remove the assignee from a Linear issue.

Parameters (1 required)

Required

issue_idstring

Linear issue ID to update.

Update Issue

update_issue

Full Description

Update fields on a Linear issue.

Parameters (2 required)

Required

issue_idstring

Linear issue ID to update.

issue_updateobject

Partial issue fields to update.

Update Project

update_project

Full Description

Update properties on a Linear project.

Parameters (2 required)

Required

project_idstring

Linear project ID to update.

update_fieldsobject

Partial project fields to update.

Links

Website Privacy Policy