| name | linear |
| description | Search, read, create, and update the user's Linear issues, projects, and comments through per-user OAuth. |
| requiredCapabilities | ["egress:api.linear.app"] |
Linear
Use this skill when the user asks about Linear issues, tickets, projects, cycles, or
their team's work tracking — finding issues, checking status, filing a bug, leaving a
comment, or updating an issue.
This is an OAuth connector. The resolved user's Linear token already lives on your
computer as an environment variable (the way a logged-in CLI's cached credential would):
$VAULT_TOKEN_API_LINEAR_APP — for api.linear.app
Linear's API is GraphQL at https://api.linear.app/graphql. Pass the token as a bearer
header (-H "Authorization: Bearer $VAULT_TOKEN_API_LINEAR_APP"). Do not ask the user for
a token, log it, or use another principal's credential.
If the variable is empty or the API returns 401/400 (authentication), tell the user they
need to connect Linear (Connectors page) and stop — don't guess at issue data.
Find / read issues
Query issues by text, assignee, or state:
curl -sS -X POST 'https://api.linear.app/graphql' \
-H "Authorization: Bearer $VAULT_TOKEN_API_LINEAR_APP" \
-H 'content-type: application/json' \
--data '{"query":"{ issues(first: 20, filter: { title: { containsIgnoreCase: \"login\" } }) { nodes { identifier title state { name } assignee { name } url } } }"}'