---
name: tracker/linear-official:project-create
description: Create a Linear project
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 Project Create

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | Yes | Project name |
| team_ids | array | Yes | Array of team IDs to associate with the project |
| description | string | No | Project description (markdown supported) |
| lead_id | string | No | User ID of the project lead |
| target_date | string | No | Target completion date in ISO 8601 format (e.g., "2026-06-30") |
| status | string | No | Initial project status (e.g., "planned", "started", "paused", "completed", "cancelled") |

## Implementation

Uses `mcp__linear__createProject` (TBD). Creates a project that groups related issues across one or more teams. A project is distinct from a cycle — projects represent goal-oriented work with a target date, while cycles are time-boxed iterations.

## Output

| Field | Type | Description |
|-------|------|-------------|
| project_id | string | Internal Linear UUID for the project |
| url | string | Direct URL to the created project |
| slug | string | URL-safe project slug |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| 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 invalid | Review parameter values and retry |

## Used By

- dev-task
