Use Linear

---
name: use-linear
description: Reference for using Linear via MCP tools. Use when creating, updating, or querying Linear issues, projects, teams, or comments.
model: haiku
effort: low
---

## Workspace

- **Team:** Michael (ID: `82e423ff-8463-4803-9822-07bcf57c8a08`)
- No need to call `list_teams` — pass `"Michael"` as the team name directly.

## Loading Tools (required before every call)

Linear MCP tools are deferred. Fetch schemas before calling:

```
ToolSearch: select:mcp__linear-server__save_issue,mcp__linear-server__list_issues
```

Use `select:<tool1>,<tool2>` with exactly the tools you need for the task.

## Common Workflows

### Create an issue

Always invoke `write-ticket-description` skill first, then:

```
mcp__linear-server__save_issue
  team: "Michael"
  title: "..."
  description: "..."   # Markdown; use real newlines, not \n
  priority: 3          # see scale below
  state: "Backlog"     # optional
```

### Update an issue

```
mcp__linear-server__save_issue
  id: "MU-5"           # issue identifier
  title: "..."         # only include fields you want to change
  state: "In Progress"
```

### List issues

```
mcp__linear-server__list_issues
  team: "Michael"
  limit: 25
```

### Get a single issue

```
mcp__linear-server__get_issue
  id: "MU-5"
```

### Add a comment

```
mcp__linear-server__save_comment
  issueId: "MU-5"
  body: "..."
```

## Priority Scale

| Value | Label   |
| ----- | ------- |
| 0     | No priority |
| 1     | Urgent  |
| 2     | High    |
| 3     | Medium  |
| 4     | Low     |

## Full Tool List

| Tool | Purpose |
| ---- | ------- |
| `save_issue` | Create or update an issue |
| `get_issue` | Fetch a single issue by ID |
| `list_issues` | List/filter issues |
| `get_issue_status` | Get status of an issue |
| `list_issue_statuses` | List available statuses for a team |
| `save_comment` | Create or update a comment |
| `list_comments` | List comments on an issue |
| `delete_comment` | Delete a comment |
| `get_project` | Fetch a project |
| `list_projects` | List projects |
| `save_project` | Create or update a project |
| `get_team` | Fetch team details |
| `list_teams` | List all teams (not needed — team is "Michael") |
| `get_user` | Fetch a user |
| `list_users` | List workspace members |
| `list_issue_labels` | List labels |
| `create_issue_label` | Create a label |
| `list_cycles` | List sprint cycles |
| `get_milestone` | Fetch a milestone |
| `list_milestones` | List milestones |
| `save_milestone` | Create or update a milestone |
| `list_documents` | List documents |
| `get_document` | Fetch a document |
| `save_document` | Create or update a document |
| `get_diff` / `list_diffs` | PR diff threads linked to issues |
| `search_documentation` | Search Linear's help docs |
| `extract_images` | Extract images from an issue or comment |