Linear MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LINEAR_API_KEYYesYour Linear API token

Schema

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
create_issue

Create a new Linear issue with optional parent linking. Supports self-assignment using "me" as assigneeId.

update_issue

Update an existing Linear issue. Supports self-assignment using "me" as assigneeId.

get_issue

Get detailed information about a specific Linear issue including optional relationships and cleaned content

search_issues

Search for Linear issues using a query string and advanced filters. Supports filtering by assignee, creator, and project. Examples: 1. Find your assigned issues: {query: "", filter: {assignedTo: "me"}}, 2. Find issues you created: {query: "", filter: {createdBy: "me"}}, 3. Find issues assigned to specific user: {query: "", filter: {assignedTo: "user-id-123"}}, 4. Find issues in a specific project: {query: "bug", projectId: "project-123"}, 5. Find issues by project name: {query: "feature", projectName: "Website Redesign"}

get_teams

Get a list of Linear teams with optional name/key filtering

create_comment

Create a new comment on a Linear issue

delete_issue

Delete an existing Linear issue

get_projects

Get a list of Linear projects with optional name filtering and pagination

get_project_updates

Get project updates for a given project ID with optional filtering parameters