Integration

Linear integration

Modern issue tracking and project management platform for software teams. Build integrations for managing issues, projects, teams, cycles, and workflows. Linear uses GraphQL API for all operations with real-time sync capabilities.

Connect Linear How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Linear.Built from the 58 Linear tools below, on the connection you add once.

Common Linear use cases

Track project progress
Archive completed projects
Build issue search functionality
Rename labels
Rename statuses
Clean up backlog
Plan new sprints
Bulk reassignment
Link design files
List integrations

What you can do with Linear

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Issue, 9 operations

archive_issueArchive issuePOSTArchives an issue, removing it from active views.
bulk_update_issuesBulk update issuesPOSTUpdates multiple issues simultaneously with the same changes.
create_issueCreate issuePOSTCreates a new issue in Linear with specified title, team, and optional metadata.
delete_issueDelete issuePOSTDeletes an issue by moving it to trash where it can be restored within 30 days.
get_issueGet issuePOSTRetrieves detailed information about a specific issue by its identifier or UUID.
list_issuesList issuesPOSTRetrieves a paginated list of issues from Linear with optional filtering by team, project, or assignee.
search_issuesSearch issuesPOSTSearches issues by text query across titles, descriptions, and comments.
unarchive_issueUnarchive issuePOSTRestores an archived issue back to active status.
update_issueUpdate issuePOSTUpdates properties of an existing issue such as title, state, assignee, or priority.

Project, 6 operations

archive_projectArchive projectPOSTArchives a project, hiding it from active views while preserving history.
create_projectCreate projectPOSTCreates a new project associated with one or more teams.
delete_projectDelete projectPOSTDeletes a project from Linear.
get_projectGet projectPOSTRetrieves detailed information about a specific project including issues and milestones.
list_projectsList projectsPOSTRetrieves a list of projects with their status, dates, progress, and associated teams.
update_projectUpdate projectPOSTUpdates properties of an existing project including name, state, and dates.

Cycle, 5 operations

archive_cycleArchive cyclePOSTArchives a completed cycle, removing it from active views.
create_cycleCreate cyclePOSTCreates a new sprint/cycle for a team with specified dates.
get_cycleGet cyclePOSTRetrieves detailed information about a specific cycle including all assigned issues.
list_cyclesList cyclesPOSTRetrieves sprint/cycle information for a team including dates and progress.
update_cycleUpdate cyclePOSTUpdates properties of an existing cycle such as dates or name.

Comment, 4 operations

add_commentAdd commentPOSTAdds a comment to an existing issue with markdown-formatted content.
delete_commentDelete commentPOSTDeletes a comment from an issue.
list_commentsList commentsPOSTRetrieves all comments on a specific issue.
update_commentUpdate commentPOSTUpdates the content of an existing comment.

Document, 4 operations

create_documentCreate documentPOSTCreates a new document in the workspace or project.
get_documentGet documentPOSTRetrieves detailed information about a specific document.
list_documentsList documentsPOSTRetrieves documents in the workspace with optional project filtering.
update_documentUpdate documentPOSTUpdates properties of an existing document including content.

Label, 4 operations

create_labelCreate labelPOSTCreates a new issue label with specified name and color.
delete_labelDelete labelPOSTDeletes (archives) a label from the workspace.
list_labelsList labelsPOSTRetrieves all issue labels with their colors and hierarchy.
update_labelUpdate labelPOSTUpdates properties of an existing label such as name or color.

Team, 4 operations

create_teamCreate teamPOSTCreates a new team in the workspace.
get_teamGet teamPOSTRetrieves detailed information about a specific team including members, states, and cycles.
list_teamsList teamsPOSTRetrieves all teams in the workspace with their workflow states and issue counts.
update_teamUpdate teamPOSTUpdates properties of an existing team.

Workflow state, 4 operations

create_workflow_stateCreate workflow statePOSTCreates a new workflow state for a team.
get_workflow_statesGet workflow statesPOSTRetrieves workflow states for a Linear team showing available issue statuses.
list_workflow_statesList workflow statesPOSTRetrieves all workflow states (issue statuses) in the workspace.
update_workflow_stateUpdate workflow statePOSTUpdates properties of an existing workflow state.

Initiative, 3 operations

create_initiativeCreate initiativePOSTCreates a new strategic initiative.
list_initiativesList initiativesPOSTRetrieves all initiatives (high-level goals) in the workspace.
update_initiativeUpdate initiativePOSTUpdates properties of an existing initiative.

Webhook, 3 operations

create_webhookCreate webhookPOSTCreates a new webhook to receive Linear events.
delete_webhookDelete webhookPOSTDeletes a webhook subscription.
list_webhooksList webhooksPOSTRetrieves all webhooks configured in the workspace.

Attachment, 2 operations

create_attachmentCreate attachmentPOSTCreates an attachment link on an issue.
link_issue_to_prLink issue to prPOSTLinks a GitHub or GitLab pull request to a Linear issue for development tracking and automation.

Milestone, 2 operations

create_milestoneCreate milestonePOSTCreates a new milestone within a project.
list_milestonesList milestonesPOSTRetrieves milestones for a specific project.

Notification, 2 operations

get_notificationsGet notificationsPOSTRetrieves notifications for the authenticated user.
mark_notification_readMark notification readPOSTMarks a notification as read/archived.

User, 2 operations

get_userGet userPOSTRetrieves detailed information about a specific user including their assigned issues.
list_usersList usersPOSTRetrieves all users in the workspace with their profile information and roles.

Issue relation, 1 operation

create_issue_relationCreate issue relationPOSTCreates a relation between two issues such as blocks, duplicate, or related.

Organization, 1 operation

get_organizationGet organizationPOSTRetrieves details about the current organization.

Roadmap, 1 operation

list_roadmapsList roadmapsPOSTRetrieves all roadmaps in the workspace with their projects.

Viewer, 1 operation

get_viewerGet viewerPOSTRetrieves the profile of the currently authenticated user.

Use Linear from Claude Code, Cursor or Codex

Connect Linear in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Linear operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Linear

Create your workspace
Sign up free. Nothing to install.
Connect Linear once
Add your Linear connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Linear integration FAQ

What can you do with the Linear integration?

LiveContext exposes 58 operations on Linear, covering issue, project, cycle and comment. Common uses include Track project progress, Archive completed projects and Build issue search functionality.