---
name: tracker/linear-official:issue-create
description: Create a Linear issue
version: "0.5.0"
---

> **Backend:** linear-official (linear@claude-plugins-official)
> **Note:** Requires `linear@claude-plugins-official` plugin. Install: `/plugin install linear@claude-plugins-official`
> **Tool names are provisional.** Exact MCP tool names will be confirmed when the Linear plugin is available. Update this file after enabling the plugin and running tool discovery.

# Linear Issue Create

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| team_id | string | Yes | Team to create the issue in |
| title | string | Yes | Issue title |
| description | string | No | Issue description (markdown supported) |
| priority | integer | No | Priority level — 0 (none), 1 (urgent), 2 (high), 3 (medium), 4 (low) |
| estimate | number | No | Story point estimate |
| labels | array | No | Array of label names or IDs |
| assignee_id | string | No | User ID to assign the issue to |
| project_id | string | No | Project to associate the issue with |
| cycle_id | string | No | Cycle (sprint) to add the issue to |

## Implementation

Uses `mcp__linear__createIssue` (TBD). Creates the issue in the specified team with all provided fields. Optional fields are omitted when not supplied.

## Output

| Field | Type | Description |
|-------|------|-------------|
| issue_id | string | Internal Linear UUID for the issue |
| identifier | string | Human-readable identifier (e.g., ENG-123) |
| url | string | Direct URL to the created issue |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| TEAM_NOT_FOUND | The specified team_id does not exist or is inaccessible | Verify team_id with linear-official:project-read |
| AUTH_FAILED | Plugin is missing, not installed, or lacks write permission | Run `/plugin install linear@claude-plugins-official` and verify plugin auth |
| VALIDATION_ERROR | Required field missing or field value is out of range | Review parameter values and retry |

## Used By

- dev-task
- dev-sprint
