# Linear (verified)

Manage issues, projects, cycles, and docs in Linear from one place. Create, update, and comment on issues; organize labels, statuses, and teams; and search docs and documentation. Stay on top of your…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add linear

# Browse available tools
npx -y @smithery/cli@latest tool list linear

# Get full schema for a tool
npx -y @smithery/cli@latest tool get linear list_comments

# Call a tool
npx -y @smithery/cli@latest tool call linear list_comments '{}'
```

## Direct MCP Connection

Endpoint: `https://linear.run.tools`

## Tools (25)

- `list_comments` — List comments for a specific Linear issue
- `create_comment` — Create a comment on a specific Linear issue
- `list_cycles` — Retrieve cycles for a specific Linear team
- `get_document` — Retrieve a Linear document by ID or slug
- `list_documents` — List documents in the user's Linear workspace
- `create_document` — Create a new document in Linear
- `update_document` — Update an existing Linear document
- `get_issue` — Retrieve detailed information about an issue by ID, including attachments and git branch name
- `list_issues` — List issues in the user's Linear workspace. For my issues, use "me" as the assignee.
- `create_issue` — Create a new Linear issue
- `update_issue` — Update an existing Linear issue
- `list_issue_statuses` — List available issue statuses in a Linear team
- `get_issue_status` — Retrieve detailed information about an issue status in Linear by name or ID
- `list_issue_labels` — List available issue labels in a Linear workspace or team
- `create_issue_label` — Create a new Linear issue label
- `list_projects` — List projects in the user's Linear workspace
- `get_project` — Retrieve details of a specific project in Linear
- `create_project` — Create a new project in Linear
- `update_project` — Update an existing Linear project
- `list_project_labels` — List available project labels in the Linear workspace
- `list_teams` — List teams in the user's Linear workspace
- `get_team` — Retrieve details of a specific Linear team
- `list_users` — Retrieve users in the Linear workspace
- `get_user` — Retrieve details of a specific Linear user
- `search_documentation` — Search Linear's documentation to learn about features and usage

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get linear <tool-name>
```
