Linear MCP by usefulapi is an MCP server published by io.usefulapi, hosted at linear.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 8 tools, including linear_search_issues, linear_get_issue, linear_list_teams, linear_list_projects, linear_my_issues.
Search, read and create Linear issues, projects, teams and cycles.
3,968 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Find issues, optionally filtered by a text query (matches title), team key, workflow-state name, or assignee email. Read-only. GraphQL: query issues(filter, first).
| Parameter | Type | Description |
|---|---|---|
| first | integer | Max issues to return. Default 25. |
| query | string | Free text to match against issue titles (containsIgnoreCase). |
| state | string | Workflow-state name, e.g. "In Progress", "Todo", "Done". |
| teamKey | string | Team key, e.g. "ENG". Filters to that team. |
| assigneeEmail | string |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| Filter to issues assigned to this user email. |
{
"name": "linear_search_issues",
"title": "Search / filter issues",
"description": "Find issues, optionally filtered by a text query (matches title), team key, workflow-state name, or assignee email. Read-only. GraphQL: query issues(filter, first).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"first": {
"type": "integer",
"maximum": 100,
"description": "Max issues to return. Default 25.",
"exclusiveMinimum": 0
},
"query": {
"type": "string",
"description": "Free text to match against issue titles (containsIgnoreCase)."
},
"state": {
"type": "string",
"description": "Workflow-state name, e.g. \"In Progress\", \"Todo\", \"Done\"."
},
"teamKey": {
"type": "string",
"description": "Team key, e.g. \"ENG\". Filters to that team."
},
"assigneeEmail": {
"type": "string",
"description": "Filter to issues assigned to this user email."
}
}
},
"annotations": {
"title": "Search / filter issues",
"readOnlyHint": true,
"openWorldHint": true
}
}Fetch a single issue by its UUID or human identifier (e.g. "ENG-123"), including description, state, assignee and recent comments. Read-only. GraphQL: query issue(id).
| Parameter | Type | Description |
|---|---|---|
| id * | string | Issue UUID or identifier like "ENG-123". |
{
"name": "linear_get_issue",
"title": "Get one issue",
"description": "Fetch a single issue by its UUID or human identifier (e.g. \"ENG-123\"), including description, state, assignee and recent comments. Read-only. GraphQL: query issue(id).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Issue UUID or identifier like \"ENG-123\"."
}
}
},
"annotations": {
"title": "Get one issue",
"readOnlyHint": true,
"openWorldHint": true
}
}List the teams in the workspace (id, key, name). Use a team's id for linear_create_issue or its key for linear_search_issues. Read-only. GraphQL: query teams.
| Parameter | Type | Description |
|---|---|---|
| first | integer | Max teams to return. Default 50. |
{
"name": "linear_list_teams",
"title": "List teams",
"description": "List the teams in the workspace (id, key, name). Use a team's id for linear_create_issue or its key for linear_search_issues. Read-only. GraphQL: query teams.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"first": {
"type": "integer",
"maximum": 250,
"description": "Max teams to return. Default 50.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List teams",
"readOnlyHint": true,
"openWorldHint": true
}
}List projects in the workspace (id, name, state, progress, target date). Read-only. GraphQL: query projects.
| Parameter | Type | Description |
|---|---|---|
| first | integer | Max projects to return. Default 50. |
{
"name": "linear_list_projects",
"title": "List projects",
"description": "List projects in the workspace (id, name, state, progress, target date). Read-only. GraphQL: query projects.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"first": {
"type": "integer",
"maximum": 250,
"description": "Max projects to return. Default 50.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List projects",
"readOnlyHint": true,
"openWorldHint": true
}
}List issues assigned to the current user (the API key's owner / OAuth actor) via viewer.assignedIssues. Read-only. GraphQL: query viewer { assignedIssues }.
| Parameter | Type | Description |
|---|---|---|
| first | integer | Max issues to return. Default 25. |
{
"name": "linear_my_issues",
"title": "My assigned issues",
"description": "List issues assigned to the current user (the API key's owner / OAuth actor) via viewer.assignedIssues. Read-only. GraphQL: query viewer { assignedIssues }.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"first": {
"type": "integer",
"maximum": 100,
"description": "Max issues to return. Default 25.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "My assigned issues",
"readOnlyHint": true,
"openWorldHint": true
}
}List cycles (sprints), optionally scoped to a team by key, with number, name and start/end dates. Read-only. GraphQL: query cycles(filter).
| Parameter | Type | Description |
|---|---|---|
| first | integer | Max cycles to return. Default 25. |
| teamKey | string | Team key, e.g. "ENG", to scope cycles to one team. |
{
"name": "linear_list_cycles",
"title": "List cycles",
"description": "List cycles (sprints), optionally scoped to a team by key, with number, name and start/end dates. Read-only. GraphQL: query cycles(filter).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"first": {
"type": "integer",
"maximum": 100,
"description": "Max cycles to return. Default 25.",
"exclusiveMinimum": 0
},
"teamKey": {
"type": "string",
"description": "Team key, e.g. \"ENG\", to scope cycles to one team."
}
}
},
"annotations": {
"title": "List cycles",
"readOnlyHint": true,
"openWorldHint": true
}
}⚠️ WRITE / MUTATING: creates a new issue in Linear. Requires a teamId (from linear_list_teams) and a title. Optional description (markdown), priority (0=none,1=urgent,2=high,3=medium,4=low), and assigneeId. GraphQL: mutation issueCreate.
| Parameter | Type | Description |
|---|---|---|
| title * | string | Issue title. |
| teamId * | string | UUID of the team to create the issue in (from linear_list_teams). |
| priority | integer | 0 none, 1 urgent, 2 high, 3 medium, 4 low. |
| assigneeId | string | UUID of the user to assign the issue to. |
| description | string | Issue body in markdown. |
{
"name": "linear_create_issue",
"title": "Create issue (WRITE — mutates Linear)",
"description": "⚠️ WRITE / MUTATING: creates a new issue in Linear. Requires a teamId (from linear_list_teams) and a title. Optional description (markdown), priority (0=none,1=urgent,2=high,3=medium,4=low), and assigneeId. GraphQL: mutation issueCreate.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"teamId",
"title"
],
"properties": {
"title": {
"type": "string",
"minLength": 1,
"description": "Issue title."
},
"teamId": {
"type": "string",
"description": "UUID of the team to create the issue in (from linear_list_teams)."
},
"priority": {
"type": "integer",
"maximum": 4,
"minimum": 0,
"description": "0 none, 1 urgent, 2 high, 3 medium, 4 low."
},
"assigneeId": {
"type": "string",
"description": "UUID of the user to assign the issue to."
},
"description": {
"type": "string",
"description": "Issue body in markdown."
}
}
},
"annotations": {
"title": "Create issue (WRITE — mutates Linear)",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}⚠️ WRITE / MUTATING: posts a comment on an issue. Requires the issueId (UUID) and a markdown body. GraphQL: mutation commentCreate.
| Parameter | Type | Description |
|---|---|---|
| body * | string | Comment text in markdown. |
| issueId * | string | UUID of the issue to comment on (the `id` field, not the ENG-123 identifier). |
{
"name": "linear_add_comment",
"title": "Add comment (WRITE — mutates Linear)",
"description": "⚠️ WRITE / MUTATING: posts a comment on an issue. Requires the issueId (UUID) and a markdown body. GraphQL: mutation commentCreate.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"issueId",
"body"
],
"properties": {
"body": {
"type": "string",
"minLength": 1,
"description": "Comment text in markdown."
},
"issueId": {
"type": "string",
"description": "UUID of the issue to comment on (the `id` field, not the ENG-123 identifier)."
}
}
},
"annotations": {
"title": "Add comment (WRITE — mutates Linear)",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Tools for Linear, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "What issues are assigned to me right now?"; "Which Engineering team issues are currently In Progress?"; "What is the progress on each of my active projects?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Linear data. Free plan: 50 tool calls per month. Run linear_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run linear_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run linear_upgrade without a plan: it returns both plans, each with a payment link for the user to open. linear_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.