stackgate.ai
All integrations

Linear

Connect Linear to Claude, ChatGPT or Cursor via MCP. OAuth or API key, teams and issues tools, and a governed private gateway.

OAuth 10 tools

Overview

Connect Linear to give AI clients access to your teams and issues for product and engineering workflows. This is the hosted Linear MCP integration for Claude, ChatGPT, Cursor, and other MCP clients — no self-hosted server required.

Common use cases

  • Linear connector for AI agents — list teams, browse issues, and update work items from chat.
  • Issue triage — create, update, comment on, or delete issues with Write access.
  • Linear OAuth or API key MCP — connect once with OAuth, or paste a personal API key; stackgate.ai stores credentials securely.
  • Private gateway — combine Linear with GitHub, Slack, and other integrations through one governed endpoint.

Prerequisites

  • A Linear account with access to the workspace you want AI to use
  • A stackgate.ai account

Getting credentials

Option A — OAuth (recommended)

  1. Sign in to stackgate.ai.
  2. Go to Integrations and open Linear.
  3. Click Activate, choose tool access (standard or scoped), then Connect Linear.
  4. Approve the OAuth prompt — stackgate.ai stores your tokens securely and refreshes them when needed.

Option B — Personal API key

  1. In Linear, open Settings → Account → Security & access and create a personal API key with the permissions you need.
  2. In stackgate.ai, open Linear under Integrations.
  3. Under Add with API key, paste the key and save.

Using with AI clients

  • Dedicated endpoint: POST /mcp/linear with a Sanctum bearer token
  • Private gateway: one config for all integrations — use linear__* namespaced tools

See Documentation for HTTP authentication and private gateway setup.

Troubleshooting

  • 422 integration not configured — complete OAuth connect or save an API key in My Integrations.
  • Token expired — disconnect and reconnect Linear (OAuth), or paste a new API key.
  • Rate limited — Linear enforces request and complexity limits; wait and retry, or ask the agent to use smaller list page sizes (first).
  • Missing write tools — enable Write access / include write tools when using scoped tool access.

Available tools

  • get_viewer

    Return the connected Linear user (id, name, email).

  • list_teams

    List Linear teams accessible to the connected account.

  • list_users

    List Linear users in the workspace (useful for assignee IDs).

  • list_workflow_states

    List workflow states for a Linear team. Call before updating issue status.

  • list_issues

    List Linear issues, optionally filtered by team, assignee, or title search text.

  • get_issue

    Get a Linear issue by UUID or identifier (for example ENG-123).

  • create_issue

    Create a Linear issue on a team.

  • update_issue

    Update a Linear issue title, description, state, assignee, or priority.

  • create_comment

    Create a comment on a Linear issue.

  • delete_issue

    Delete (trash) a Linear issue. Issues stay in trash for 30 days unless permanently removed in Linear.

MCP endpoint: https://stackgate.ai/mcp/linear (HTTP) or via the private gateway.

Create account Documentation