Linear integration
Linear
Linear
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.
- 01Connect
Your user grants Linear access once (OAuth) — the token lands in the vault.
- 02Call
Your agent calls a tool over MCP or the typed API; Open Connector injects the credential server-side.
- 03Audit
Every routed call appends a hash-chained audit record — nothing leaves your infra.
Tools & triggers
Supported Linear tools and triggers.
Browse 39 tools and 2 triggers in the Linear catalog. Each action uses your configured authentication and tool allowlist.
Showing 39 tools.
- 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
- 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
- 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
- Create an issue with teamId and title. Look up team, workflow state, label, and assignee IDs with the corresponding list tools; optionally set projectId, cycleId, or parentId.
- 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
- List Linear issue labels
- Lists Linear issue labels visible to the connected account.
- labelsissuesread
- Create Linear issue label
- Creates a Linear issue label at workspace or team scope.
- labelsissueswrite
- 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
- Update an issue by ID or identifier, such as ENG-123. Supply only changed fields in input; use stateId to move it through the workflow and assigneeId to reassign it.
- issueswrite
- Get Linear organization
- Gets the current Linear workspace organization.
- organizationread
- List Linear projects
- Lists Linear projects in the workspace.
- projectsread
- 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
- Edit project fields such as name, description, leadId, targetDate, or statusId. Supply only changed fields in input. To publish a status update post, use Create Linear project update.
- projectswrite
- Create Linear project update
- Creates a status update post for a Linear project.
- projectsproject-updateswrite
- 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
- 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 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 users
- Lists users in the Linear workspace.
- usersread
- Get Linear user
- Gets a Linear user by id.
- 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
- Linear Issue Comment Createdwebhook
- Triggered when a comment is created on an issue in a selected Linear team scope.
- Linear Issue Createdwebhook
- Triggered when an issue is created in a selected Linear team scope.
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.