Linear

Track issues, manage projects and cycles across your workspace.

Install

amodal connect linear

Authentication

Bearer token authentication via GraphQL.

• LINEAR_API_KEY — Personal API key from Linear Settings > API > Personal API keys

All requests are POST to the single GraphQL endpoint at https://api.linear.app/graphql.

Endpoints

Queries

• POST /graphql query.issues — List/filter issues
• POST /graphql query.issue — Get issue by ID
• POST /graphql query.projects — List projects
• POST /graphql query.project — Get project details
• POST /graphql query.cycles — List cycles
• POST /graphql query.teams — List teams
• POST /graphql query.comments — List comments on issue

Mutations

• POST /graphql mutation.issueCreate — Create an issue (confirmation)
• POST /graphql mutation.issueUpdate — Update an issue (confirmation)
• POST /graphql mutation.commentCreate — Add comment to issue (confirmation)
• POST /graphql mutation.commentUpdate — Update a comment (confirmation)
• POST /graphql mutation.issueArchive — Archive an issue (confirmation)
• POST /graphql mutation.issueDelete — Permanently delete an issue (disabled)
• POST /graphql mutation.projectCreate — Create a project (confirmation)
• POST /graphql mutation.projectDelete — Delete a project (confirmation)

Entities

• graphql

Rules

• Rate limit: 1,500 requests/hour per API key with complexity-based limiting on deeply nested queries
• Priority numbering is inverted: 1 is highest (Urgent), 4 is lowest (Low), 0 is None
• Workflow states are per-team, not global — query team.states to get valid states for a team
• Issue identifiers (ENG-123) are different from UUIDs — most mutations accept either format