How to integrate Linear MCP with Codex

Archives an existing Linear issue by its UUID or shorthand identifier, removing it from active views while preserving its data for future reference.

Archives an existing Linear project by its UUID, removing it from active views.

Archives a project update in Linear, hiding it from the default view while preserving its data.

Creates a new attachment and associates it with a specific, existing Linear issue.

Tool to add a reaction to an existing Linear comment.

Creates a new comment on a specified Linear issue.

Creates an issue in a specified Linear team with a title and optional project, description, assignee, state, priority, cycle, due date, and other properties.

Create a relationship between two Linear issues using the issueRelationCreate mutation.

Creates a label for a specified Linear team, or returns an existing exact-name match found in the team's initial label results.

Creates a new Linear project with specified name and team associations.

Tool to create a project milestone in Linear with a name and optional target date and sort order.

Tool to create a project status update post for a Linear project.

Creates a new team in Linear with the specified name and key.

Archives an existing Linear issue by its ID, which is Linear's standard way of deleting issues; the operation is idempotent.

Downloads a Linear Attachment record or a private upload embedded in issue/comment Markdown; `file_name` must include the correct extension.

Retrieves a single Linear comment by its unique ID.

Gets the currently authenticated Linear user's ID, name, email, and other profile information.

Lists cycles for a specified Linear team ID, including progress, creation and end times, and history.

Fetches a Linear team's default issue estimate and state, useful for pre-filling new issue forms.

Retrieves a Linear issue by UUID or shorthand identifier, including its details, parent, cycle, attachments, comments and subscribers.

Retrieves a single Linear project by its unique identifier.

Retrieves a specific project update by its unique identifier.

Lists comments from Linear workspace accessible to the authenticated user.

Lists the connected user's issue drafts for review or editing.

Tool to list all issues for a specific Linear team, scoped by team ID.

Lists cycles across the Linear account without filters, including team IDs and scheduled end times.

Lists non-archived Linear issues with optional project and assignee filters, returning a paginated issues array and page_info.

Retrieves paginated Linear issue labels for a specified team or across the workspace.

Retrieves all projects from the Linear account.

Retrieves all workflow states for a specified team in Linear, representing the stages an issue progresses through in that team's workflow.

Lists visible Linear teams with their members and project IDs, with pagination for teams but not nested members or projects.

Lists workspace users with IDs, names, emails, and active status.

Retrieves all project updates from the Linear workspace.

Removes a specified label from a Linear issue using the issue and label IDs, and returns the updated issue and labels.

Tool to remove a reaction on a comment.

Marks a Linear comment as resolved.

Execute a Linear GraphQL query or mutation to retrieve or change accessible data.

Searches Linear issues by full-text query, with pagination and an option to include archived issues.

Unarchive a previously archived project update in Linear.

Unresolves a previously resolved Linear comment, marking it as requiring attention again.

Updates an existing Linear issue by ID, requiring at least one field to modify; supplied fields overwrite existing values and labels replace the label set.

Tool to update an existing Linear comment's body text.

Tool to update an existing Linear project.

Tool to update an existing Linear project update post.

Updates an existing Linear team's settings, including its name, key, cycle settings, and workflow state configuration.

Validates the Linear API credentials by checking if the authentication token can successfully query the current user.

Return the identity (name, email) of the connected Linear account.