> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.airweave.ai/docs/connectors/linear/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.airweave.ai/_mcp/server.

# Linear

> Linear integration with Airweave

![Linear logo](/_fern-files/docs.airweave.ai/766322044ab6d3ca58e1c1deb782859007d1080f97d856d337ae05a8818974e0/docs/pages/connectors/linear/icon.svg)

# Linear

This connector enables AI agents and RAG systems to retrieve context from Linear through Airweave's unified search layer.

## Configuration

Linear source connector — syncs teams, projects, users, issues, comments, attachments.

#### [View Source Code](https://github.com/airweave-ai/airweave/tree/main/backend/airweave/platform/sources/linear.py)

Explore the Linear connector implementation

### Authentication

This connector uses **OAuth 2.0 authentication**. You can connect through the Airweave UI or API using the OAuth flow.

**Supported authentication methods:**

* OAuth Browser Flow (recommended for UI)
* OAuth Token (for programmatic access)
* Auth Provider (enterprise SSO)

### Configuration Options

This connector does not have any additional configuration options.

## Data Models

The following data models are available for this connector:

#### LinearTeamEntity

Schema for Linear team entities.

| Field           | Type            | Description                                    |
| --------------- | --------------- | ---------------------------------------------- |
| team\_id        | str             | Unique Linear ID for the team.                 |
| team\_name      | str             | Display name of the team.                      |
| created\_time   | datetime        | When the team was created.                     |
| updated\_time   | datetime        | When the team was last updated.                |
| key             | str             | The team's unique key used in URLs             |
| description     | Optional\[str]  | The team's description                         |
| color           | Optional\[str]  | The team's color                               |
| icon            | Optional\[str]  | The icon of the team                           |
| private         | Optional\[bool] | Whether the team is private or not             |
| timezone        | Optional\[str]  | The timezone of the team                       |
| parent\_id      | Optional\[str]  | ID of the parent team, if this is a sub-team   |
| parent\_name    | Optional\[str]  | Name of the parent team, if this is a sub-team |
| issue\_count    | Optional\[int]  | Number of issues in the team                   |
| web\_url\_value | Optional\[str]  | URL to view the team in Linear                 |

#### LinearProjectEntity

Schema for Linear project entities.

| Field           | Type                  | Description                                   |
| --------------- | --------------------- | --------------------------------------------- |
| project\_id     | str                   | Unique Linear ID of the project.              |
| project\_name   | str                   | Display name of the project.                  |
| created\_time   | datetime              | When the project was created.                 |
| updated\_time   | datetime              | When the project was last updated.            |
| slug\_id        | str                   | The project's unique URL slug                 |
| description     | Optional\[str]        | The project's description                     |
| priority        | Optional\[int]        | The priority level of the project             |
| state           | Optional\[str]        | The current state/status name of the project  |
| completed\_at   | Optional\[Any]        | When the project was completed, if applicable |
| started\_at     | Optional\[Any]        | When the project was started, if applicable   |
| target\_date    | Optional\[str]        | The estimated completion date of the project  |
| start\_date     | Optional\[str]        | The estimated start date of the project       |
| team\_ids       | Optional\[List\[str]] | IDs of the teams this project belongs to      |
| team\_names     | Optional\[List\[str]] | Names of the teams this project belongs to    |
| progress        | Optional\[float]      | The overall progress of the project           |
| lead            | Optional\[str]        | Name of the project lead, if any              |
| web\_url\_value | Optional\[str]        | URL to view the project in Linear             |

#### LinearUserEntity

Schema for Linear user entities.

| Field                 | Type                  | Description                                              |
| --------------------- | --------------------- | -------------------------------------------------------- |
| user\_id              | str                   | Unique Linear ID for the user.                           |
| display\_name         | str                   | The user's display name, unique within the organization. |
| created\_time         | datetime              | When the user account was created.                       |
| updated\_time         | datetime              | When the user account was last updated.                  |
| email                 | str                   | The user's email address                                 |
| avatar\_url           | Optional\[str]        | URL to the user's avatar image                           |
| description           | Optional\[str]        | A short description of the user                          |
| timezone              | Optional\[str]        | The local timezone of the user                           |
| active                | Optional\[bool]       | Whether the user account is active or disabled           |
| admin                 | Optional\[bool]       | Whether the user is an organization administrator        |
| guest                 | Optional\[bool]       | Whether the user is a guest with limited access          |
| last\_seen            | Optional\[Any]        | The last time the user was seen online                   |
| status\_emoji         | Optional\[str]        | The emoji to represent the user's current status         |
| status\_label         | Optional\[str]        | The label of the user's current status                   |
| status\_until\_at     | Optional\[Any]        | Date at which the user's status should be cleared        |
| created\_issue\_count | Optional\[int]        | Number of issues created by the user                     |
| team\_ids             | Optional\[List\[str]] | IDs of the teams this user belongs to                    |
| team\_names           | Optional\[List\[str]] | Names of the teams this user belongs to                  |
| web\_url\_value       | Optional\[str]        | URL to view the user in Linear                           |

#### LinearIssueEntity

Schema for Linear issue entities.

| Field           | Type           | Description                                           |
| --------------- | -------------- | ----------------------------------------------------- |
| issue\_id       | str            | Unique Linear ID of the issue.                        |
| identifier      | str            | The unique identifier of the issue (e.g., 'ENG-123'). |
| title           | str            | The title of the issue.                               |
| created\_time   | datetime       | When the issue was created.                           |
| updated\_time   | datetime       | When the issue was last updated.                      |
| description     | Optional\[str] | The description/content of the issue                  |
| priority        | Optional\[int] | The priority level of the issue                       |
| state           | Optional\[str] | The current state/status name of the issue            |
| completed\_at   | Optional\[Any] | When the issue was completed, if applicable           |
| due\_date       | Optional\[str] | The due date for the issue, if set                    |
| team\_id        | Optional\[str] | ID of the team this issue belongs to                  |
| team\_name      | Optional\[str] | Name of the team this issue belongs to                |
| project\_id     | Optional\[str] | ID of the project this issue belongs to, if any       |
| project\_name   | Optional\[str] | Name of the project this issue belongs to, if any     |
| assignee        | Optional\[str] | Name of the user assigned to this issue, if any       |
| web\_url\_value | Optional\[str] | URL to view the issue in Linear.                      |

#### LinearCommentEntity

Schema for Linear comment entities.

| Field             | Type           | Description                                         |
| ----------------- | -------------- | --------------------------------------------------- |
| comment\_id       | str            | Unique ID of the comment.                           |
| body\_preview     | str            | Preview of the comment body for display.            |
| created\_time     | datetime       | When the comment was created.                       |
| updated\_time     | datetime       | When the comment was last updated.                  |
| issue\_id         | str            | ID of the issue this comment belongs to             |
| issue\_identifier | str            | Identifier of the issue (e.g., 'ENG-123')           |
| body              | str            | The content/body of the comment                     |
| user\_id          | Optional\[str] | ID of the user who created the comment              |
| user\_name        | Optional\[str] | Name of the user who created the comment            |
| team\_id          | Optional\[str] | ID of the team this comment belongs to              |
| team\_name        | Optional\[str] | Name of the team this comment belongs to            |
| project\_id       | Optional\[str] | ID of the project this comment belongs to, if any   |
| project\_name     | Optional\[str] | Name of the project this comment belongs to, if any |
| web\_url\_value   | Optional\[str] | URL to view the comment in Linear                   |

#### LinearAttachmentEntity

Schema for Linear attachment entities extracted from issue descriptions.

| Field             | Type                       | Description                                |
| ----------------- | -------------------------- | ------------------------------------------ |
| attachment\_id    | str                        | Unique identifier for the attachment.      |
| issue\_id         | str                        | ID of the issue this attachment belongs to |
| issue\_identifier | str                        | Identifier of the issue (e.g., 'ENG-123')  |
| title             | str                        | Title of the attachment                    |
| subtitle          | Optional\[str]             | Subtitle of the attachment                 |
| source            | Optional\[Dict\[str, Any]] | Source information about the attachment    |
| web\_url\_value   | Optional\[str]             | Viewer URL for the attachment.             |

> Linear integration with Airweave