> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Issues, teams and cycles, with an API key. The Linear server above signs in instead — use this to hold a key rather than a session.

Issues, teams and cycles, with an API key. The Linear server above signs in instead — use this to hold a key rather than a session.

## Connecting

In the dashboard, open **Connectors**, find Linear and press **Connect**. The key you enter is checked against Linear before anything is saved, so a key that is refused never becomes a connection that fails later.

### What you will need

| Field | What it is |
| - | - |
| API Key | Your Linear API key |

### Getting the credential

1. Log in to [Linear](https://linear.app)
2. Go to **Settings** → **Account** → **API**
3. Under **Personal API keys**, click **Create new API key**
4. Enter a name for your API key
5. Select appropriate scopes (read/write as needed)
6. Copy the generated API key

## What your AI teammate can do with it

| Tool | What it does |
| - | - |
| `get_viewer` | Get current user information |
| `get_teams` | List all teams |
| `get_team` | Get team details |
| `get_issues` | List issues with filtering |
| `get_issue` | Get issue details |
| `create_issue` | Create a new issue |
| `update_issue` | Update an existing issue |
| `delete_issue` | Delete an issue |
| `get_projects` | List all projects |
| `get_project` | Get project details |
| `create_project` | Create a new project |
| `get_users` | List organization users |
| `get_workflow_states` | Get workflow states for a team |
| `get_labels` | List available labels |
| `create_comment` | Add a comment to an issue |
| `get_comments` | Get comments for an issue |

## Useful resources

* [Linear documentation](https://developers.linear.app/docs/graphql/working-with-the-graphql-api)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.