---
title: Linear | Keycard
description: Issue tracking and project management for software teams
---

Integrate Linear issue tracking with your AI workflow. Search and create issues, manage project cycles, update issue statuses, and track team progress. Ideal for engineering teams that want AI-assisted project management.

Adding Linear provisions three things in your zone: an upstream resource pointing at `https://mcp.linear.app/mcp` (kept inside Keycard), a Keycard MCP Gateway URL - the downstream resource - that you install in Cursor, Claude Code, or any MCP client, and a provider for token exchange with Linear’s OAuth issuer.

When your AI client makes a tool call, it sends a Keycard-issued access token to the gateway URL. Keycard’s STS exchanges that token for an upstream Linear token, the gateway calls the upstream MCP, and the response is proxied back. Your zone’s [identity provider](/admin/identity-providers/index.md), [access policies](/admin/access-policies/index.md), and audit log apply to every call - the upstream credential never leaves Keycard. Each call is recorded in the audit log with the user identity, the resource accessed, and the policy decision.

## Tools

TOOLS

Tools the upstream server exposes through the Keycard MCP Gateway.

Linear exposes 42 tools through the gateway:

- get\_attachment

  Get a Linear attachment's content by ID

- create\_attachment

  Upload a base64 attachment to a Linear issue

- delete\_attachment

  Delete a Linear attachment by ID

- list\_comments

  List comments for a specific Linear issue

- save\_comment

  Create or update a comment on a Linear issue

- delete\_comment

  Delete a comment from a Linear issue

- list\_cycles

  List cycles for a Linear team

- get\_document

  Get a Linear document by ID or slug

- list\_documents

  List documents in a Linear workspace

- create\_document

  Create a new Linear document

- update\_document

  Update an existing Linear document

- extract\_images

  Extract images from markdown in issues or docs

- get\_issue

  Get Linear issue details with attachments

- list\_issues

  List issues in a Linear workspace

- Create or update a Linear issue

  Create or update a Linear issue

- list\_issue\_statuses

  List issue statuses for a Linear team

- get\_issue\_status

  Get a Linear issue status by name or ID

- list\_issue\_labels

  List issue labels in a Linear workspace or team

- create\_issue\_label

  Create a new Linear issue label

- list\_projects

  List projects in the user's Linear workspace

- get\_project

  Get Linear project details by ID

- save\_project

  Create or update a Linear project

- list\_project\_labels

  List project labels in a Linear workspace

- list\_milestones

  List milestones in a Linear project

- get\_milestone

  Get a milestone by ID or name

- save\_milestone

  Create or update a Linear project milestone

- list\_teams

  List teams in a Linear workspace

- get\_team

  Get Linear team details by ID

- list\_users

  List users in a Linear workspace

- get\_user

  Get Linear user details by ID

- search\_documentation

  Search Linear docs for features and usage

- list\_customers

  List customers in a Linear workspace

- save\_customer

  Create or update a Linear customer

- Delete a Linear customer

  Delete a customer in Linear

- save\_customer\_need

  Create or update a customer need in Linear

- delete\_customer\_need

  Archive a customer need in Linear

- list\_initiatives

  List initiatives in a Linear workspace

- get\_initiative

  Get Linear initiative details by ID

- save\_initiative

  Create or update a Linear initiative

- get\_status\_updates

  List project or initiative status updates

- save\_status\_update

  Create or update a status update

- delete\_status\_update

  Archive a project or initiative status update

Show all 42 tools  Show fewer

## Install

INSTALL

Add Linear to your zone and install the gateway URL into Cursor, Claude Code, or any MCP client.

1. **Open the catalog**

   In your zone’s [Keycard Console](https://console.keycard.ai), go to **Applications** → **Add Application** → **Explore MCP Servers**.

2. **Find and install Linear**

   Search for `Linear` in the catalog and click **Install**.

3. **Connect your development tool**

   Once installed, Linear appears on the **Applications** page with a **Keycard MCP Gateway URL**. Use the **Install** dropdown to add it to Cursor, Claude Code, or any MCP-compatible client.

## Related

RELATED

- [Catalog overview](/admin/catalog/index.md) - browse other MCP and API servers
- [Access policies](/admin/access-policies/index.md) - control who can use Linear
- [Identity providers](/admin/identity-providers/index.md) - control who can sign in

[PreviousKlaviyo](/admin/catalog/mcp-servers/klaviyo/index.md)[NextMapbox](/admin/catalog/mcp-servers/mapbox/index.md)