Skip to content
API Reference
Admin /Catalog /MCP Servers
Linear logo

Linear

Productivity

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, access policies, 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

Section titled “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

Install

Section titled “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, 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.

Section titled “Related”
RELATED