Linear

Linear MCP Server for Cloudflare Workers

Available Tools

56 tools available in the Linear MCP server. Each tool can be called by AI assistants to perform specific actions.

linear_get_viewer

Get the currently authenticated user.

Returns information about the user associated with the API key.

Args:

format: Response format

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_list_users

List all users in the organization.

Args:

first: Number of users to return (default: 50)
after: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_list_attachments

List attachments on an issue.

Args:

issueId: Issue ID (required)
first: Number of attachments to return (default: 50)
after: Pagination cursor
format: Response format

{
  "type": "object",
  "required": [
    "issueId"
  ],
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "issueId": {
      "type": "string",
      "description": "Issue ID"
    }
  }
}

linear_create_attachment

Create an attachment on an issue.

Attachments are external links that can be associated with issues.

Args:

issueId: Issue ID (required)
title: Attachment title (required)
url: Attachment URL (required)
subtitle: Attachment subtitle
iconUrl: Icon URL for the attachment
commentBody: Optional comment to add with the attachment

{
  "type": "object",
  "required": [
    "issueId",
    "title",
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Attachment URL"
    },
    "title": {
      "type": "string",
      "description": "Attachment title"
    },
    "iconUrl": {
      "type": "string"
    },
    "issueId": {
      "type": "string",
      "description": "Issue ID"
    },
    "subtitle": {
      "type": "string"
    },
    "commentBody": {
      "type": "string",
      "description": "Comment to add with attachment"
    }
  }
}

linear_update_attachment

Update an existing attachment.

Args:

id: Attachment ID (required)
title: New title
url: New URL
subtitle: New subtitle
iconUrl: New icon URL

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Attachment ID"
    },
    "url": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "iconUrl": {
      "type": "string"
    },
    "subtitle": {
      "type": "string"
    }
  }
}

linear_delete_attachment

Delete an attachment.

Args:

id: Attachment ID

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Attachment ID"
    }
  }
}

linear_list_comments

List comments on an issue.

Args:

issueId: Issue ID (required)
first: Number of comments to return (default: 50)
after: Pagination cursor
format: Response format

{
  "type": "object",
  "required": [
    "issueId"
  ],
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "issueId": {
      "type": "string",
      "description": "Issue ID"
    }
  }
}

linear_get_user

Get a single user by ID.

Args:

id: User ID
format: Response format

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_create_comment

Create a comment on an issue.

Args:

issueId: Issue ID (required)
body: Comment body in markdown (required)
parentId: Parent comment ID (for replies)

{
  "type": "object",
  "required": [
    "issueId",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Comment body (markdown)"
    },
    "issueId": {
      "type": "string",
      "description": "Issue ID"
    },
    "parentId": {
      "type": "string",
      "description": "Parent comment ID for replies"
    }
  }
}

linear_update_comment

Update an existing comment.

Args:

id: Comment ID (required)
body: New comment body in markdown

{
  "type": "object",
  "required": [
    "id",
    "body"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Comment ID"
    },
    "body": {
      "type": "string",
      "description": "New comment body (markdown)"
    }
  }
}

linear_delete_comment

Delete a comment.

Args:

id: Comment ID

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Comment ID"
    }
  }
}

linear_list_cycles

List cycles (sprints) for a team.

Args:

teamId: Team ID (required)
first: Number of cycles to return (default: 50)
after: Pagination cursor
format: Response format

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID"
    }
  }
}

linear_get_cycle

Get a single cycle by ID.

Args:

id: Cycle ID
format: Response format

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Cycle ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_create_cycle

Create a new cycle (sprint) for a team.

Args:

teamId: Team ID (required)
startsAt: Start date/time (ISO 8601, required)
endsAt: End date/time (ISO 8601, required)
name: Cycle name (optional)
description: Cycle description (optional)

{
  "type": "object",
  "required": [
    "teamId",
    "startsAt",
    "endsAt"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Cycle name"
    },
    "endsAt": {
      "type": "string",
      "description": "End date/time (ISO 8601)"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID"
    },
    "startsAt": {
      "type": "string",
      "description": "Start date/time (ISO 8601)"
    },
    "description": {
      "type": "string",
      "description": "Cycle description"
    }
  }
}

linear_update_cycle

Update an existing cycle.

Args:

id: Cycle ID
name: New name
description: New description
startsAt: New start date/time
endsAt: New end date/time
completedAt: Completion date/time (null to unmark as completed)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Cycle ID"
    },
    "name": {
      "type": "string"
    },
    "endsAt": {
      "type": "string"
    },
    "startsAt": {
      "type": "string"
    },
    "completedAt": {
      "type": "string"
    },
    "description": {
      "type": "string"
    }
  }
}

linear_archive_cycle

Archive a cycle.

Args:

id: Cycle ID

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Cycle ID"
    }
  }
}

linear_list_documents

List documents in Linear.

Args:

projectId: Filter by project ID (optional)
first: Number of documents to return (default: 50)
after: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "string",
      "description": "Filter by project ID"
    }
  }
}

linear_get_document

Get a single document by ID.

Args:

id: Document ID
format: Response format

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Document ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_create_document

Create a new document.

Args:

title: Document title (required)
content: Document content (markdown)
icon: Document icon
color: Document color
projectId: Associated project ID

{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "icon": {
      "type": "string"
    },
    "color": {
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Document title"
    },
    "content": {
      "type": "string",
      "description": "Document content (markdown)"
    },
    "projectId": {
      "type": "string"
    }
  }
}

linear_update_document

Update an existing document.

Args:

id: Document ID (required)
title: New title
content: New content (markdown)
icon: New icon
color: New color
projectId: New project ID (null to remove)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Document ID"
    },
    "icon": {
      "type": "string"
    },
    "color": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "content": {
      "type": "string"
    },
    "projectId": {
      "type": "string"
    }
  }
}

linear_update_project_milestone

Update a project milestone.

Args:

id: Milestone ID
name: New name
description: New description
targetDate: New target date (null to remove)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Milestone ID"
    },
    "name": {
      "type": "string"
    },
    "targetDate": {
      "type": "string"
    },
    "description": {
      "type": "string"
    }
  }
}

linear_list_issues

List issues from Linear with optional filters.

Returns a paginated list of issues. Use filters to narrow results by team, project, cycle, assignee, etc.

Args:

teamId: Filter by team ID
projectId: Filter by project ID
cycleId: Filter by cycle ID
assigneeId: Filter by assignee ID
creatorId: Filter by creator ID
stateId: Filter by workflow state ID
priority: Filter by priority (0=none, 1=urgent, 2=high, 3=medium, 4=low)
first: Number of issues to return (default: 50)
after: Pagination cursor
includeArchived: Include archived issues
format: Response format ('json' or 'markdown')

{
  "type": "object",
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of issues to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "teamId": {
      "type": "string",
      "description": "Filter by team ID"
    },
    "cycleId": {
      "type": "string",
      "description": "Filter by cycle ID"
    },
    "stateId": {
      "type": "string",
      "description": "Filter by workflow state ID"
    },
    "priority": {
      "type": "integer",
      "maximum": 4,
      "minimum": 0,
      "description": "Filter by priority (0=none, 1=urgent, 2=high, 3=medium, 4=low)"
    },
    "creatorId": {
      "type": "string",
      "description": "Filter by creator ID"
    },
    "projectId": {
      "type": "string",
      "description": "Filter by project ID"
    },
    "assigneeId": {
      "type": "string",
      "description": "Filter by assignee ID"
    },
    "includeArchived": {
      "type": "boolean",
      "default": false,
      "description": "Include archived issues"
    }
  }
}

linear_get_issue

Get a single issue by ID or identifier.

Args:

id: Issue ID or identifier (e.g., "ABC-123")
format: Response format ('json' or 'markdown')

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Issue ID or identifier"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_get_organization

Get organization information.

Returns details about the organization including subscription, settings, and statistics.

Args:

format: Response format

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_search_issues

Search for issues using Linear's search functionality.

Supports natural language queries and Linear's search syntax.

Args:

query: Search query string
first: Number of results (default: 50)
after: Pagination cursor
format: Response format

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_create_issue

Create a new issue in Linear.

Args:

teamId: Team ID (required)
title: Issue title (required)
description: Issue description (markdown supported)
priority: Priority (0=none, 1=urgent, 2=high, 3=medium, 4=low)
estimate: Story points estimate
assigneeId: Assignee user ID
labelIds: Array of label IDs
projectId: Project ID
projectMilestoneId: Project milestone ID
cycleId: Cycle ID
stateId: Workflow state ID
parentId: Parent issue ID (for sub-issues)
dueDate: Due date (YYYY-MM-DD)

{
  "type": "object",
  "required": [
    "teamId",
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Issue title"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID (required)"
    },
    "cycleId": {
      "type": "string",
      "description": "Cycle ID"
    },
    "dueDate": {
      "type": "string",
      "description": "Due date (YYYY-MM-DD)"
    },
    "stateId": {
      "type": "string",
      "description": "Workflow state ID"
    },
    "estimate": {
      "type": "number",
      "description": "Story points estimate"
    },
    "labelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Label IDs"
    },
    "parentId": {
      "type": "string",
      "description": "Parent issue ID"
    },
    "priority": {
      "type": "integer",
      "maximum": 4,
      "minimum": 0,
      "description": "Priority level"
    },
    "projectId": {
      "type": "string",
      "description": "Project ID"
    },
    "assigneeId": {
      "type": "string",
      "description": "Assignee user ID"
    },
    "description": {
      "type": "string",
      "description": "Issue description (markdown)"
    },
    "projectMilestoneId": {
      "type": "string",
      "description": "Project milestone ID"
    }
  }
}

linear_update_issue

Update an existing issue.

Args:

id: Issue ID or identifier
title: New title
description: New description
priority: New priority
estimate: New estimate
assigneeId: New assignee (null to unassign)
labelIds: New label IDs
projectId: New project (null to remove)
projectMilestoneId: New milestone (null to remove)
cycleId: New cycle (null to remove)
stateId: New workflow state
parentId: New parent issue (null to make top-level)
dueDate: New due date (null to remove)
trashed: Move to trash

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Issue ID"
    },
    "title": {
      "type": "string"
    },
    "cycleId": {
      "type": "string"
    },
    "dueDate": {
      "type": "string"
    },
    "stateId": {
      "type": "string"
    },
    "trashed": {
      "type": "boolean"
    },
    "estimate": {
      "type": "number"
    },
    "labelIds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "parentId": {
      "type": "string"
    },
    "priority": {
      "type": "integer",
      "maximum": 4,
      "minimum": 0
    },
    "projectId": {
      "type": "string"
    },
    "assigneeId": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "projectMilestoneId": {
      "type": "string"
    }
  }
}

linear_archive_issue

Archive an issue.

Args:

id: Issue ID

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Issue ID"
    }
  }
}

linear_unarchive_issue

Unarchive an issue.

Args:

id: Issue ID

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Issue ID"
    }
  }
}

linear_list_labels

List issue labels.

Args:

teamId: Filter by team ID (optional - omit for workspace labels)
first: Number of labels to return (default: 50)
after: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamId": {
      "type": "string",
      "description": "Filter by team ID"
    }
  }
}

linear_delete_project_milestone

Delete a project milestone.

Args:

id: Milestone ID

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Milestone ID"
    }
  }
}

linear_create_label

Create a new issue label.

Args:

name: Label name (required)
color: Label color (hex, e.g., "#ff0000")
description: Label description
teamId: Team ID (optional - omit for workspace label)
parentId: Parent label ID (for sub-labels)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Label name"
    },
    "color": {
      "type": "string",
      "description": "Label color (hex)"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID"
    },
    "parentId": {
      "type": "string",
      "description": "Parent label ID"
    },
    "description": {
      "type": "string"
    }
  }
}

linear_update_label

Update an existing label.

Args:

id: Label ID (required)
name: New name
color: New color (hex)
description: New description

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Label ID"
    },
    "name": {
      "type": "string"
    },
    "color": {
      "type": "string"
    },
    "description": {
      "type": "string"
    }
  }
}

linear_archive_label

Archive a label.

Args:

id: Label ID

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Label ID"
    }
  }
}

linear_list_notifications

List notifications for the authenticated user.

Args:

first: Number of notifications to return (default: 50)
after: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_mark_notification_read

Mark a notification as read.

Args:

id: Notification ID

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Notification ID"
    }
  }
}

linear_archive_notification

Archive a notification.

Args:

id: Notification ID

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Notification ID"
    }
  }
}

linear_list_projects

List projects from Linear.

Args:

teamId: Filter by team ID
first: Number of projects to return (default: 50)
after: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamId": {
      "type": "string",
      "description": "Filter by team ID"
    }
  }
}

linear_get_project

Get a single project by ID.

Args:

id: Project ID
format: Response format

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Project ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_list_webhooks

List webhooks in the organization.

Args:

first: Number of webhooks to return (default: 50)
after: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_create_project

Create a new project in Linear.

Args:

name: Project name (required)
teamIds: Array of team IDs (required)
description: Project description
icon: Project icon
color: Project color
state: Project state (planned, started, paused, completed, canceled)
leadId: Project lead user ID
memberIds: Array of member user IDs
targetDate: Target completion date (YYYY-MM-DD)
startDate: Start date (YYYY-MM-DD)

{
  "type": "object",
  "required": [
    "name",
    "teamIds"
  ],
  "properties": {
    "icon": {
      "type": "string"
    },
    "name": {
      "type": "string",
      "description": "Project name"
    },
    "color": {
      "type": "string"
    },
    "state": {
      "type": "string",
      "description": "Project state"
    },
    "leadId": {
      "type": "string"
    },
    "teamIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Team IDs"
    },
    "memberIds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "startDate": {
      "type": "string"
    },
    "targetDate": {
      "type": "string"
    },
    "description": {
      "type": "string"
    }
  }
}

linear_update_project

Update an existing project.

Args:

id: Project ID
name: New name
description: New description
icon: New icon
color: New color
state: New state
leadId: New lead (null to remove)
memberIds: New member IDs
targetDate: New target date (null to remove)
startDate: New start date (null to remove)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Project ID"
    },
    "icon": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "color": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "leadId": {
      "type": "string"
    },
    "memberIds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "startDate": {
      "type": "string"
    },
    "targetDate": {
      "type": "string"
    },
    "description": {
      "type": "string"
    }
  }
}

linear_archive_project

Archive a project.

Args:

id: Project ID

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Project ID"
    }
  }
}

linear_list_project_milestones

List milestones for a project.

Args:

projectId: Project ID
first: Number of milestones to return
after: Pagination cursor
format: Response format

{
  "type": "object",
  "required": [
    "projectId"
  ],
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "projectId": {
      "type": "string",
      "description": "Project ID"
    }
  }
}

linear_create_project_milestone

Create a milestone for a project.

Args:

projectId: Project ID (required)
name: Milestone name (required)
description: Milestone description
targetDate: Target date (YYYY-MM-DD)

{
  "type": "object",
  "required": [
    "projectId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Milestone name"
    },
    "projectId": {
      "type": "string",
      "description": "Project ID"
    },
    "targetDate": {
      "type": "string"
    },
    "description": {
      "type": "string"
    }
  }
}

linear_list_issue_relations

List relations for an issue.

Issue relations can be: blocks, duplicate, or related.

Args:

issueId: Issue ID (required)
format: Response format

{
  "type": "object",
  "required": [
    "issueId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "issueId": {
      "type": "string",
      "description": "Issue ID"
    }
  }
}

linear_create_issue_relation

Create a relation between two issues.

Relation types:

blocks: The issue blocks the related issue
duplicate: The issue is a duplicate of the related issue
related: The issues are related

Args:

issueId: Source issue ID (required)
relatedIssueId: Related issue ID (required)
type: Relation type (blocks, duplicate, related)

{
  "type": "object",
  "required": [
    "issueId",
    "relatedIssueId",
    "type"
  ],
  "properties": {
    "type": {
      "enum": [
        "blocks",
        "duplicate",
        "related"
      ],
      "type": "string",
      "description": "Relation type"
    },
    "issueId": {
      "type": "string",
      "description": "Source issue ID"
    },
    "relatedIssueId": {
      "type": "string",
      "description": "Related issue ID"
    }
  }
}

linear_delete_issue_relation

Delete an issue relation.

Args:

id: Relation ID

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Relation ID"
    }
  }
}

linear_list_initiatives

List initiatives in the organization.

Initiatives are high-level strategic goals that can contain multiple projects.

Args:

first: Number of initiatives to return (default: 50)
after: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_list_roadmaps

List roadmaps in the organization.

Roadmaps provide a visual timeline view of projects and initiatives.

Args:

first: Number of roadmaps to return (default: 50)
after: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_list_teams

List all teams in the organization.

Args:

first: Number of teams to return (default: 50)
after: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_get_team

Get a single team by ID.

Args:

id: Team ID
format: Response format

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Team ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

linear_list_workflow_states

List workflow states for a team.

Workflow states define the status options for issues (e.g., Todo, In Progress, Done).

Args:

teamId: Team ID (required)
first: Number of states to return
after: Pagination cursor
format: Response format

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "after": {
      "type": "string"
    },
    "first": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID"
    }
  }
}

linear_create_webhook

Create a new webhook.

Args:

url: Webhook URL (required)
resourceTypes: Array of resource types to subscribe to (required) Valid types: Issue, Comment, IssueLabel, Project, Cycle, Reaction, Attachment, ProjectUpdate
label: Webhook label
teamId: Team ID (optional - omit for all teams)
allPublicTeams: Subscribe to all public teams
enabled: Whether the webhook is enabled

{
  "type": "object",
  "required": [
    "url",
    "resourceTypes"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Webhook URL"
    },
    "label": {
      "type": "string"
    },
    "teamId": {
      "type": "string"
    },
    "enabled": {
      "type": "boolean"
    },
    "resourceTypes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Resource types to subscribe to"
    },
    "allPublicTeams": {
      "type": "boolean"
    }
  }
}

linear_update_webhook

Update an existing webhook.

Args:

id: Webhook ID (required)
url: New URL
resourceTypes: New resource types
label: New label
enabled: Enable/disable the webhook

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Webhook ID"
    },
    "url": {
      "type": "string"
    },
    "label": {
      "type": "string"
    },
    "enabled": {
      "type": "boolean"
    },
    "resourceTypes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

linear_delete_webhook

Delete a webhook.

Args:

id: Webhook ID

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Webhook ID"
    }
  }
}