Skip to main content
Integrate with Linear to enable Potpie agents to fetch issue details, update issue status, and manage project workflows directly within the development environment.

​
Connecting Linear

  1. Go to Potpie → Integrations
  2. Click Connect Linear
  3. Complete the OAuth consent screen on Linear’s side
  4. Potpie stores your access token encrypted in PostgreSQL, linked to your Linear organization
One Linear organization maps to one integration per user.

​
What Agents Can Do

Once connected, agents can use two Linear tools when included in the agent’s tool list.
ToolWhat it does
get_linear_issueFetches an issue by ID returning title, description, status, assignee, team, priority, URL, created_at, and updated_at
update_linear_issueUpdates any combination of title, description, status, assignee, or priority. Adding a comment creates a separate comment and does not overwrite the description.
These tools can be accessed by both the custom agents and the pre-built agents.

​
Token Resolution

When an agent calls a Linear tool, Potpie resolves the token in the following order:
  1. Per-user OAuth token from the secrets manager
  2. LINEAR_API_KEY environment variable is used as a system-wide fallback when no per-user token is present
If neither is found, the tool returns an error prompting the user to connect Linear first.

​
Webhooks

Linear can send issue and project events to Potpie in real time. Webhook delivery uses a webhook secret for signature verification, separate from the user OAuth token.