Linear Integration Guide
Connect your AI agent to Linear for issue management, project tracking, cycle planning, and team workload visibility using a Personal API key.
What your agent can do
Full project management capabilities through the Linear GraphQL API.
Issue management
Create, update, assign, and close issues. Your agent can file bug reports, create feature requests, and manage issue lifecycle from triage to completion.
Project tracking
Access projects, milestones, and roadmaps. Your agent can check project status, move issues between states, and report on progress.
Cycle planning
View and manage development cycles. Your agent can check what is planned for the current cycle, suggest scope adjustments, and track velocity.
Label management
Apply, remove, and create labels on issues. Your agent can categorize work, prioritize items, and filter issues by label for reporting.
Prerequisites
What you need before connecting Linear to your agent.
- A Linear account with access to the workspace your agent needs
- A Personal API key from Settings > API in Linear
- A ClawTrust agent on any plan (Starter, Pro, or Enterprise)
Step-by-step setup
Connect Linear to your agent in about 3 minutes.
Open Linear Settings
Log into Linear and click on your workspace name in the sidebar. Go to Settings > API (under "My Account").
Create a Personal API key
Under "Personal API keys", click "Create key". Give it a label like "ClawTrust Agent". Copy the key immediately. Linear only shows it once.
Add the credential in ClawTrust
In your agent's dashboard, go to Credentials > Add Credential. Select "API Key (Bearer)" as the type. Paste the Linear API key as the value. Set allowed domains to *.linear.app and api.linear.app.
Test the connection
Click "Test" on the credential card. ClawTrust will verify the key against the Linear GraphQL API. Ask your agent to list your teams or recent issues to confirm access.
Credential details
Reference for the credential configuration fields.
Security note
Your Linear API key is encrypted with AES-256-GCM before storage. The credential proxy restricts all outbound requests to *.linear.app and api.linear.app. The key inherits the permissions of the user who created it. You can revoke it from Linear Settings at any time. For team use, consider creating a dedicated service account in Linear.
Example actions
Things you can ask your agent to do once Linear is connected.
Create a bug issue in the Frontend team with priority Urgent and assign it to me
List all issues in the current cycle that are still in the Backlog state
Move all completed issues from this cycle to Done and add a comment with the summary
Show me the team workload breakdown for the current sprint
Add the label 'customer-reported' to all issues created from support tickets this week
Ready to connect your agent to Linear?
Issue tracking in 3 minutes. Encrypted credentials, domain-locked proxy, full audit log.