List configured Linear workspaces with PAT prefix + primary status.

Returns a dict with workspaces (list of redacted profiles), primary (alias of the default workspace), and errors (config errors found at load time). Tokens never appear in the response.

Verify PAT validity for each workspace + report draft store + audit log path.

For each workspace, calls the viewer query. Returns user info + the organization the PAT is scoped to. A failure means the PAT has been revoked or rotated and needs re-generation at linear.app/settings/account/security.

List teams in a Linear workspace.

workspace selects which configured PAT to use (defaults to primary). first is the page size (max 250); after is the cursor from a previous response's pageInfo.endCursor.

Get a Linear team by its UUID. Includes workflow states inline.

List users in a Linear workspace.

include_disabled flips the Linear includeDisabled filter so you can see members who have been removed from the org.

Get a Linear user by ID. Pass me to look up the PAT owner.

For me, the server resolves it via the viewer query and substitutes the resolved id.

List projects.

team_id scopes to projects involving one team. state filters by project state (one of: backlog, planned, started, paused, completed, canceled). Omit for all.

Get a Linear project by UUID.

Create or update a Linear project.

Pass id to update an existing project; omit id (and pass team_ids) to create a new one. Linear requires at least one team when creating.

Dates are ISO-8601 strings (YYYY-MM-DD). priority is 0-4 (0=none, 1=urgent, 2=high, 3=medium, 4=low).

List initiatives in the workspace.

Initiatives are Linear's top-level org-wide goals that contain multiple projects.

Get an initiative by UUID.

Create or update an initiative.

Pass id to update; omit to create. Status is one of Planned, Active, Completed (string, not enum) per Linear's API.

List issues with common filters.

assignee_id accepts a user UUID or the literal me. state_type accepts one of: backlog, unstarted, started, completed, canceled, triage. query does a full-text search across title + description. filter lets you pass a raw Linear IssueFilter for cases the convenience args don't cover.

order_by is updatedAt (default) or createdAt.

Get a single issue.

id accepts either the UUID or the human identifier (e.g. ONDE-123). When given an identifier, the tool resolves it through a one-shot search.

Create or update an issue.

Pass id to update. Creating requires title and team_id. assignee_id accepts a UUID or me. priority is 0-4 (0=none, 1=urgent, 2=high, 3=medium, 4=low).

Apply the same update to multiple issues in one round-trip.

ids is a list of issue UUIDs. Every other arg is an optional field to set on all of them (skip args you don't want to change). Linear's issueBatchUpdate mutation does the work server-side — way faster than N separate save_issue calls for bulk ops like "mark these 50 as Done" or "reassign these to me."

auth_phrase (REQUIRED, v0.3) must be one of: "go", "yes do it", "confirmed", "execute", "go cancel", "go update". Without this explicit confirmation a single hallucinated arg could mass-modify pre-existing shared workspace data — surface the requirement to the operator and capture their explicit phrase before calling this tool.

List cycles, optionally scoped to one team.

team_id is the team UUID. Omit to list cycles across every team.

List project milestones. project_id scopes to one project.

Get a project milestone by UUID.

Create or update a project milestone.

Pass id to update. Creating requires name and project_id.

List workflow states (issue statuses) per team.

team_id scopes results to one team. Omit to list every workflow state across the workspace.

Return the current workflow state for one issue (id or identifier).

Convenience tool: the existing get_issue already returns state, but this is the minimal-fields variant for status-driven automations.

List issue labels. team_id scopes to one team; omit for org-wide.

Create a new issue label.

team_id makes a team-scoped label. Omit for workspace-scoped. color is a 7-char hex (#RRGGBB). parent_id nests this label under another (Linear supports two-level label hierarchies).

List comments. Scope by issue_id or project_id.

Create or update a comment.

Pass id to edit an existing comment (only body is updateable). Creating requires body and either issue_id or project_id. parent_id threads the comment as a reply.

List documents in the workspace.

Get a document by UUID.

Create or update a document.

Pass id to update. Creating requires title and one of project_id or initiative_id (documents attach to a project or initiative in Linear's model).

Post a status update against a project.

health is one of onTrack, atRisk, offTrack (Linear enums). body is markdown.

Full-text search across issues in the workspace.

Backed by Linear's searchIssues GraphQL field (verified via introspection). Returns nodes with the standard issue shape plus a totalCount so the agent knows how many more hits exist beyond the current page.

Full-text search across workspace documents (NOT Linear's dev docs).

Full-text search across projects in the workspace.

Semantic search across the entire workspace.

Returns heterogeneous nodes (issues, projects, documents, comments, initiatives). Each node carries __typename so the agent can branch on entity kind.

Use this when the search target is conceptual ("payment retry logic") rather than exact-string ("PAY-123").

List webhooks configured for the workspace.

Get a webhook by UUID.

Create a webhook subscription.

url is your HTTPS receiver. resource_types defaults to ["Issue", "Comment", "IssueLabel"] if omitted — adjust as needed (full list at linear.app/developers/webhooks). team_id scopes to one team; all_public_teams=True subscribes to every public team in the org. secret is your HMAC signing secret — Linear adds it to the Linear-Signature header on every event.

Update an existing webhook by UUID.

Delete a webhook. Destructive — uses draft+confirm.

Two-call flow:

1. delete_webhook(id=...) returns a draft_id plus a preview of which webhook is about to go away.

2. delete_webhook(id=..., confirm_draft_id=<draft_id>) actually issues webhookDelete against Linear.

Drafts expire after 1 hour (override with LINEAR_MCP_DRAFT_TTL_SECONDS).

List notifications in the viewer's inbox.

unread_only=True restricts to notifications with no readAt. Nodes carry __typename (IssueNotification, ProjectNotification, etc.) so an agent can branch on category.

Get one notification by UUID.

Return the count of unread notifications in the inbox.

Mark a notification read (or unread by passing read=False).

Mark every notification in the inbox as read.

category optionally scopes to one notification category (e.g. triageResponsibility, assigned).

Archive a notification (removes from inbox; reversible).

List attachments on one issue.

Reverse lookup: every attachment record across the workspace pointing at this URL. Useful to find which issue references a given Slack thread / PR / external doc.

Get one attachment by UUID.

Attach an arbitrary URL to an issue.

Linear renders the link in the issue sidebar. Pass title and icon_url to customize the display; otherwise Linear fetches OpenGraph metadata from the URL.

Delete an attachment. Destructive — uses draft+confirm.

Two-call flow identical to delete_webhook. The first call returns a draft_id + preview of the attachment that will be removed; the second call (with confirm_draft_id) commits.

List issue relations. issue_id filters to relations involving one issue.

Create a relation between two issues.

type must be one of: blocks (issue blocks related_issue), duplicate (issue duplicates related_issue), or related (no directionality). Linear automatically creates the inverse relation visible on the other issue.

Delete an issue relation by ID. Non-destructive (no cascade).

List agent sessions. issue_id scopes to one issue.

Get an agent session by UUID.

Open an agent session attached to an issue.

session_type is one of comment (the agent posts a comment as its output) or commentThread (the agent threads under existing comments). external_url lets the agent surface a link back to its own dashboard / run log.

Open an agent session attached to a comment (typically a @mention of the agent app user).