Skip to main content

Overview

Buckle connects AI agents to Linear through OAuth. Agents can search issues and projects, create and update issues, and leave comments. The gateway injects the token into every request, so your agent never sees it. On Buckle Cloud, connecting takes one click. Self-hosted, you first add your own Linear app (see the bottom of this page).

What you will set up

  • A Linear connection through OAuth
  • Automatic token injection on every Linear request
  • Per-agent, per-tool access, with approval for deletes

Connect Linear

1

Click Connect

In the Buckle dashboard, open Settings > Apps > Linear and click Connect Linear.
Buckle connect window for Linear, showing the setup guide link and the Connect to Linear button.

The Linear connect window in Buckle.

2

Authorize in Linear

Sign in to Linear, pick your workspace, and click Authorize. You’re done.

What agents can do

Controlling access

Grant the connection to each agent that needs it, and choose per tool what runs freely, what needs approval, and what’s blocked. Put Delete issue behind approval. Organization rules add guardrails on top. A blocked request never reaches Linear. To disconnect, remove the connection in Settings > Apps > Linear, then revoke Buckle in Linear under Settings > Account > Security & access.

Self-hosted: use your own Linear app

Skip this section on Buckle Cloud. Self-hosted Buckle needs either LINEAR_CLIENT_ID and LINEAR_CLIENT_SECRET on the server, or your own Linear app added below.

1. Create the Linear app

In Linear, open Settings > API > OAuth applications and click Create new. Name it Buckle.
Linear new OAuth application form with the name Buckle, a developer name and URL, and https://buckle.example.com/v1/apps/linear/callback in Callback URLs.

The new OAuth application form in Linear, with the Buckle callback URL.

In Buckle, open Settings > Apps > Linear > Custom credentials and copy the Redirect URI. Paste it into the Linear app’s Callback URLs and save.
Buckle Custom credentials card for Linear with the setup guide link, the Redirect URI and its copy button, and the client ID and secret fields.

Copy the Redirect URI from Custom credentials in Buckle.

Copy the app’s Client ID and Client Secret into Custom credentials, turn it on, then click Connect Linear.

FAQ

No. On Buckle Cloud you connect with OAuth in one click. Self-hosted, you add your own Linear app first. See Self-hosted.
No. The token stays in Buckle, and the gateway adds it at the proxy. See How it works.
Remove the connection in Settings > Apps > Linear, then revoke Buckle in Linear under Settings > Account > Security & access.