INDIVIDUAL MCP TOOL

linear_list_teams

List the teams in the workspace (id, key, name).

usefulapi.ionone authenticationAvailability not checked

LIVE ENDPOINT

https://linear.usefulapi.io/mcp

No auth detected

Connect to this endpoint to inspect the live schema for linear_list_teams and invoke it with your own arguments.

{}

Inferred read-only · medium confidence · heuristic, not a guarantee.

No write-capable action terms were found; this is not proof that invocation has no side effects.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.linear-mcp]
url = "https://linear.usefulapi.io/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "linear-mcp": {
      "type": "http",
      "url": "https://linear.usefulapi.io/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: linear-mcp
Remote MCP URL: https://linear.usefulapi.io/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "linear-mcp": {
      "url": "https://linear.usefulapi.io/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "linear-mcp": {
      "type": "http",
      "url": "https://linear.usefulapi.io/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "linear-mcp",
  "transport": "streamable-http",
  "url": "https://linear.usefulapi.io/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

linear_search_issues — Find issues, optionally filtered by a text query (matches title), team key, workflow-state name, or assignee email.
linear_get_issue — Fetch a single issue by its UUID or human identifier (e.
linear_list_projects — List projects in the workspace (id, name, state, progress, target date).
linear_my_issues — List issues assigned to the current user (the API key's owner / OAuth actor) via viewer.
linear_list_cycles — List cycles (sprints), optionally scoped to a team by key, with number, name and start/end dates.
linear_create_issue — ⚠️ WRITE / MUTATING: creates a new issue in Linear.
linear_add_comment — ⚠️ WRITE / MUTATING: posts a comment on an issue.