Linear

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Enabled by default.
  • Authentication: OAuth 2.0.
  • Connection: A user authorizes the connection in the provider's consent screen.
  • Scopes: read, write.

Credentials

Set these per environment. See Connect an integration.

These variables are required only when you supply your own OAuth app. If a managed app is available, you can connect without setting them. Provider permissions and consent still apply.

VariableRequiredDescription
LINEAR_CLIENT_IDYesLinear OAuth Client ID (from your OAuth application) Docs.
LINEAR_CLIENT_SECRETYesLinear OAuth Client Secret Docs.

Setup

  1. Choose who owns the Linear OAuth app: On hosted Veryfront, Linear uses the Veryfront-managed Linear OAuth app: connect Linear from the project's integrations and approve the Linear consent screen, no environment variables needed. Set LINEAR_CLIENT_ID and LINEAR_CLIENT_SECRET only to use your own Linear OAuth app, which is required for local and self-hosted runs.
  2. Create an OAuth application: In Linear, open Settings, then API, and create a new OAuth application.
  3. Set the callback URLs: Add the redirect URI of the environment that completes the flow: https://api.veryfront.com/oauth/callback/linear for hosted Veryfront, or your app origin followed by /api/auth/linear/callback for a local or self-hosted app. Set LINEAR_CLIENT_ID and LINEAR_CLIENT_SECRET from the app's credentials.
  4. Verify access: Run List Teams (read-only). It returns the teams of the connected Linear workspace without changing anything.

Provider notes

  • The connection requests read and write. write is only needed by the tools that create or update issues and comments.
  • Tools that create, update, send or delete data are marked as writes and need write authority; the other tools are read-only.

Provider API reference.

Tools

ToolAccessDescription
Search Issues<br /><code className="reference-identifier">linear__search_issues</code>ReadSearch issues
Get Issue<br /><code className="reference-identifier">linear__get_issue</code>ReadGet issue
Create Issue<br /><code className="reference-identifier">linear__create_issue</code>WriteCreate issue
Update Issue<br /><code className="reference-identifier">linear__update_issue</code>WriteUpdate issue
Delete Issue<br /><code className="reference-identifier">linear__delete_issue</code>WriteArchive or delete issue
List Projects<br /><code className="reference-identifier">linear__list_projects</code>ReadList projects
List Teams<br /><code className="reference-identifier">linear__list_teams</code>ReadList teams
List Workflow States<br /><code className="reference-identifier">linear__list_workflow_states</code>ReadList workflow states
List Users<br /><code className="reference-identifier">linear__list_users</code>ReadList users
Add Comment<br /><code className="reference-identifier">linear__add_comment</code>WriteAdd comment
List Issue Labels<br /><code className="reference-identifier">linear__list_issue_labels</code>ReadList issue labels

Verify the connection

Call a read tool such as linear__search_issues with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.