Linear integrationLinear logo

Linear integration for AI agents.

Let your AI agents work in Linear — create and update issues, manage cycles and projects, and search the backlog — through a routed, audited connection. Open Connector runs the OAuth, seals the token in an encrypted vault, and serves Linear tools to your agent over MCP or a typed API — credentials injected server-side, every call audited, nothing leaving your infrastructure. Open source (AGPL-3.0) and self-hostable.

What your agents can do

Real Linear actions, managed and audited.

Your user connects Linear once; your agent can then create and update issues, manage cycles and projects, and search the backlog — scoped to the OAuth permissions you grant and the tool allowlist you configure. Every action is least-privilege and written to a tamper-evident audit trail.

  1. 1

    Your user grants Linear access once (OAuth) — the token lands in the vault.

  2. 2

    Your agent calls a tool over MCP or the typed API; Open Connector injects the credential server-side.

  3. 3

    Every routed call appends a hash-chained audit record — nothing leaves your infra.

Tools & triggers

Supported Linear tools.

39 tools are generated from the published Linear catalog. Descriptions are plain text; each action remains subject to its configured authentication and tool allowlist.

Showing 39 tools. All published catalog entries are included in this page's server-rendered HTML.

Create Linear comment
Creates a comment on a Linear issue or project.
commentswrite
Update Linear comment
Updates the body of an existing Linear comment.
commentswrite
List Linear cycles
Lists Linear cycles visible to the connected account.
cyclesread
Download Linear issue attachment
Downloads a specific attachment from a Linear issue into the session blob store and returns a downloadable URL.
attachmentsissuesdownloadread
Run Linear GraphQL query or mutation
Executes an arbitrary GraphQL query or mutation against Linear's API using the connected account. Use this escape hatch when reviewed tools do not cover the needed operation.
graphqladvancedreadwrite
Archive Linear issue
Archives a Linear issue, optionally moving it to trash.
issueswritedestructiveHint
List Linear issue attachments
Lists attachment metadata and URLs for a Linear issue. Use returned URLs to download externally when supported by the attachment source.
attachmentsissuesread
List Linear issue comments
Lists comments on a Linear issue.
commentsissuesread
Create Linear issue
Creates a Linear issue in a team.
issueswrite
List Linear issue drafts
Lists issue drafts created by the authenticated Linear user.
issuesdraftsread
Get Linear issue
Retrieves a Linear issue by id or issue identifier, including labels, recent comments, and attachment URLs.
issuescommentsattachmentsread
Create Linear issue label
Creates a Linear issue label at workspace or team scope.
labelsissueswrite
List Linear issue labels
Lists Linear issue labels visible to the connected account.
labelsissuesread
Create Linear issue relation
Creates a relationship between two Linear issues.
issuesrelationswrite
Remove Linear issue label
Removes a label from a Linear issue.
issueslabelswrite
Update Linear issue
Updates a Linear issue using an IssueUpdateInput object.
issueswrite
List Linear issues
Lists Linear issues visible to the connected account.
issuesread
Search Linear issues
Searches Linear issues by text query across identifier, title, description, and optionally comments.
issuessearchread
Get Linear organization
Gets the current Linear workspace organization.
organizationread
Create Linear project
Creates a Linear project associated with one or more teams.
projectswrite
Get Linear project
Gets a Linear project by id or URL slug.
projectsread
List Linear project issues
Lists issues associated with a Linear project.
projectsissuesread
Create Linear project milestone
Creates a Linear project milestone with name, project id, and optional target date or sort order.
projectsmilestoneswrite
Update Linear project
Updates a Linear project using a ProjectUpdateInput object.
projectswrite
Create Linear project update
Creates a status update post for a Linear project.
projectsproject-updateswrite
List Linear projects
Lists Linear projects in the workspace.
projectsread
Delete Linear reaction
Deletes a Linear reaction by reaction id. To remove a reaction from a comment, pass the reaction id returned by Linear.
reactionscommentswritedestructiveHint
Get Linear create issue defaults
Gets a Linear team default issue estimate and default workflow state for pre-filling issue creation.
teamsissuesdefaultsread
List Linear team cycles
Lists cycles for a specified Linear team.
cyclesteamsread
Get Linear team
Gets a Linear team by id.
teamsread
List Linear team issues
Lists issues belonging to a Linear team.
teamsissuesread
List Linear team workflow states
Lists workflow states for a specified Linear team.
workflow-statesteamsread
List Linear teams
Lists Linear teams.
teamsread
List Linear teams with members and projects
Lists Linear teams with their members and projects.
teamsusersprojectsread
Get Linear user
Gets a Linear user by id.
usersread
List Linear users
Lists users in the Linear workspace.
usersread
List assigned Linear issues
Lists issues assigned to the authenticated Linear user.
issuesassigneeread
Get Linear viewer
Gets the authenticated Linear user.
viewerread
List Linear workflow states
Lists Linear issue workflow states across visible teams.
workflow-statesread
FAQ

Linear integration, answered

How do AI agents use Linear through Open Connector?
Your user connects Linear once (OAuth). Open Connector stores the token in an encrypted vault and exposes Linear tools to your agent over MCP or a typed API, injecting the credential server-side on each call — the agent never sees a raw token, and every action is audited.
Is this a Linear MCP server?
Yes. Open Connector can serve Linear as a named MCP server with a scoped tool allowlist and a per-user mcp_url, so any MCP client connects and calls Linear tools with credentials routed server-side.
Where do Linear OAuth tokens live?
In your own infrastructure. Self-host Open Connector and the Linear token is sealed in an AES-256-GCM vault in your Postgres, injected at call time — it never leaves your environment.

Give your agents Linear — keep the keys.

Open source, self-hostable, with Linear credentials that never leave your infrastructure. Run it from source today.