Linear
Track issues and manage projects with Linear. Modern issue tracker popular with engineering teams. Create issues from form submissions or automations.
🔑 Setup Required — Bring Your Own Key
This integration requires API credentials. Store them once via
setup_integration or the Dashboard Vault — they're encrypted
with AES-256-GCM and never exposed.
Required Credentials
linear_api_key
API Key
Personal API key from linear.app → Settings → API → Personal API keys. Starts with "lin_api_".
Get your API key at linear.app →
Endpoints (3)
POST
list-issues
List recent issues. Returns title, status, assignee, priority, and creation date. Last 20 issues.
| Field | Type | Required | Description |
|---|---|---|---|
query |
string | ✓ Yes | GraphQL query. Use: "{ issues(first: 20, orderBy: createdAt) { nodes { id title state { name } assignee { name } priority createdAt } } }" |
POST
create-issue
Create a new issue in Linear. Requires team ID (get from list-teams query).
| Field | Type | Required | Description |
|---|---|---|---|
query |
string | ✓ Yes | GraphQL mutation. Use: "mutation { issueCreate(input: { teamId: \"TEAM_ID\", title: \"Bug report\", description: \"Details here\" }) { success issue { id identifier title url } } }" |
POST
list-teams
List all teams. Returns team ID, name, and key. Need team ID for creating issues.
| Field | Type | Required | Description |
|---|---|---|---|
query |
string | ✓ Yes | GraphQL query. Use: "{ teams { nodes { id name key } } }" |
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| list-issues | linear_list_issues |
| create-issue | linear_create_issue |
| list-teams | linear_list_teams |