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.

Linear API settings Developer docs MCP server docs

Install

INSTALL

Add Linear to your zone and connect it to your MCP client.

Step 1 - Install in Keycard Console

In your zone’s Keycard Console, go to Applications -> Add Application -> Explore MCP Servers.
Search for Linear and click Install.
A browser tab opens to Linear’s OAuth consent screen. Sign in and approve the requested permissions.
You’re redirected back. Linear appears on the Applications page with a Keycard MCP Gateway URL.

Step 2 - Connect your MCP client

On the Applications page, click Add to Coding Agent next to Linear and pick how you want to install:

Cursor - opens a deeplink that hands the MCP config straight to Cursor. Click Install inside Cursor to finish.
Claude Code - opens a dialog with a claude mcp add command. Pick a scope (User, Project, or Local), then copy and run the command in your terminal.
Install manually - reveals the Server Name and Server URL to paste into any other MCP-compatible client.

Once connected, Linear’s tools are available to the agent, scoped to whoever signs in to your zone.

Tools

TOOLS

What Linear can do once installed.

Linear provides 42 tools:

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

Next steps

NEXT STEPS

What to do once Linear is installed.

Now do this

Confirm the gateway works by asking your AI client to call one of the Linear tools above.

Recommended

Decide who can use it - write access policies scoped to the Linear resource so only the right users and agents reach the tools.
Watch the calls - every tool call lands in your audit log with user identity, resource, and policy decision.

Optional

Add REST API access too - install the Linear API server for backend code that calls Linear on behalf of users.