Linear MCP (multi-workspace, PAT auth)

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.

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.

Get a project milestone by UUID.

Get one notification by UUID.

Get a Linear project by UUID.

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

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.

Get a webhook by UUID.

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.

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.

List agent sessions. `issue_id` scopes to one issue.

List attachments on one issue.

List comments. Scope by `issue_id` or `project_id`.

List cycles, optionally scoped to one team. `team_id` is the team UUID. Omit to list cycles across every team.

List documents in the workspace.

List initiatives in the workspace. Initiatives are Linear's top-level org-wide goals that contain multiple projects.

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

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

List workflow states (issue statuses) per team. `team_id` scopes results to one team. Omit to list every workflow state across the workspace.

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`.

List project milestones. `project_id` scopes to one project.

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.

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.

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.

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.

List webhooks configured for the workspace.

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.

Mark every notification in the inbox as read. `category` optionally scopes to one notification category (e.g. `triageResponsibility`, `assigned`).

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

Return the count of unread notifications in the inbox.

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.

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).

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.

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).

Create or update a project milestone. Pass `id` to update. Creating requires `name` and `project_id`.

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).

Post a status update against a project. `health` is one of `onTrack`, `atRisk`, `offTrack` (Linear enums). `body` is markdown.

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

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 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").

Update an existing webhook by UUID.