Linear

Get the currently authenticated user. Returns information about the user associated with the API key. Args: - format: Response format

List all users in the organization. Args: - first: Number of users to return (default: 50) - after: Pagination cursor - format: Response format

List attachments on an issue. Args: - issueId: Issue ID (required) - first: Number of attachments to return (default: 50) - after: Pagination cursor - format: Response format

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

Update an existing attachment. Args: - id: Attachment ID (required) - title: New title - url: New URL - subtitle: New subtitle - iconUrl: New icon URL

Delete an attachment. Args: - id: Attachment ID

List comments on an issue. Args: - issueId: Issue ID (required) - first: Number of comments to return (default: 50) - after: Pagination cursor - format: Response format

Get a single user by ID. Args: - id: User ID - format: Response format

Create a comment on an issue. Args: - issueId: Issue ID (required) - body: Comment body in markdown (required) - parentId: Parent comment ID (for replies)

Update an existing comment. Args: - id: Comment ID (required) - body: New comment body in markdown

Delete a comment. Args: - id: Comment ID

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

Get a single cycle by ID. Args: - id: Cycle ID - format: Response format

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)

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)

Archive a cycle. Args: - id: Cycle ID

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

Get a single document by ID. Args: - id: Document ID - format: Response format

Create a new document. Args: - title: Document title (required) - content: Document content (markdown) - icon: Document icon - color: Document color - projectId: Associated project ID

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)

Update a project milestone. Args: - id: Milestone ID - name: New name - description: New description - targetDate: New target date (null to remove)

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

Get a single issue by ID or identifier. Args: - id: Issue ID or identifier (e.g., "ABC-123") - format: Response format ('json' or 'markdown')

Get organization information. Returns details about the organization including subscription, settings, and statistics. Args: - format: Response format

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

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)

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

Archive an issue. Args: - id: Issue ID

Unarchive an issue. Args: - id: Issue ID

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

Delete a project milestone. Args: - id: Milestone ID

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)

Update an existing label. Args: - id: Label ID (required) - name: New name - color: New color (hex) - description: New description

Archive a label. Args: - id: Label ID

List notifications for the authenticated user. Args: - first: Number of notifications to return (default: 50) - after: Pagination cursor - format: Response format

Mark a notification as read. Args: - id: Notification ID

Archive a notification. Args: - id: Notification ID

List projects from Linear. Args: - teamId: Filter by team ID - first: Number of projects to return (default: 50) - after: Pagination cursor - format: Response format

Get a single project by ID. Args: - id: Project ID - format: Response format

List webhooks in the organization. Args: - first: Number of webhooks to return (default: 50) - after: Pagination cursor - format: Response format

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)

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)

Archive a project. Args: - id: Project ID

List milestones for a project. Args: - projectId: Project ID - first: Number of milestones to return - after: Pagination cursor - format: Response format

Create a milestone for a project. Args: - projectId: Project ID (required) - name: Milestone name (required) - description: Milestone description - targetDate: Target date (YYYY-MM-DD)

List relations for an issue. Issue relations can be: blocks, duplicate, or related. Args: - issueId: Issue ID (required) - format: Response format

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)

Delete an issue relation. Args: - id: Relation ID

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

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

List all teams in the organization. Args: - first: Number of teams to return (default: 50) - after: Pagination cursor - format: Response format

Get a single team by ID. Args: - id: Team ID - format: Response format

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

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

Update an existing webhook. Args: - id: Webhook ID (required) - url: New URL - resourceTypes: New resource types - label: New label - enabled: Enable/disable the webhook

Delete a webhook. Args: - id: Webhook ID