Linear MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LINEAR_API_KEYYesYour Linear API key (create at https://linear.app/settings/account/security)

Schema

Prompts

Interactive templates invoked by user choice

NameDescription
defaultGet the default prompt for the Linear MCP server.

Resources

Contextual data attached and managed by the client

NameDescription
linear-organization:
linear-viewer:

Tools

Functions exposed to the LLM to take actions

NameDescription
linear_create_issue

Create a new Linear issue.

Args: title: Issue title team_id: Team ID to create issue in description: Issue description (markdown supported) priority: Priority level (1=urgent, 4=low) status: Initial status name
linear_update_issue

Update an existing Linear issue.

Args: id: Issue ID to update title: New title description: New description priority: New priority (1=urgent, 4=low) status: New status name
linear_search_issues

Search issues with flexible filtering.

Args: query: Text to search in title/description team_id: Filter by team status: Filter by status assignee_id: Filter by assignee labels: Filter by labels priority: Filter by priority estimate: Filter by estimate points include_archived: Include archived issues limit: Max results (default: 10)
linear_get_user_issues

Get issues assigned to a user.

Args: user_id: User ID (omit for authenticated user) include_archived: Include archived issues limit: Max results (default: 50)
linear_add_comment

Add a comment to an issue.

Args: issue_id: Issue ID to comment on body: Comment text (markdown supported) create_as_user: Custom username display_icon_url: Custom avatar URL