Linear MCP Server

The Linear MCP server provides comprehensive integration with Linear's project management platform, enabling seamless interaction with issues, projects, teams, documents, and more directly through the Model Context Protocol. This server allows you to query, create, and update Linear resources programmatically, making it an essential tool for automating workflows and managing your development process. Whether you're tracking bugs, planning sprints, or coordinating with team members, this server brings Linear's powerful features into your MCP-enabled environment.

Overview

Linear is a modern issue tracking and project management tool designed for software development teams. This MCP server exposes Linear's core functionality through a set of well-defined tools that allow you to interact with your Linear workspace without leaving your development environment. From creating and updating issues to managing projects, labels, and team cycles, this server provides the building blocks for sophisticated Linear automation and integration workflows.

Features

Complete Issue Management

Manage your Linear issues with full CRUD operations, including support for sub-issues, attachments, labels, assignments, and more. Search and filter issues by team, assignee, state, project, cycle, and custom queries. Retrieve detailed issue information including git branch names for seamless development integration.

Project and Team Operations

Create and manage projects with team assignments, project leads, labels, and timelines. List and retrieve team information, including team members and configurations. Track project progress and coordinate work across multiple teams.

Document Management

Access and search Linear documents to maintain project documentation, technical specs, and team knowledge bases. Filter documents by creator, project, initiative, and timestamps to quickly find relevant information.

Comment System

Engage in discussions by listing and creating comments on issues. Support for threaded conversations through parent comment replies enables rich collaboration on specific topics.

Cycle Planning

Retrieve cycle information for sprint planning and tracking. Access current, previous, and next cycles to understand team velocity and plan upcoming work.

Label Organization

Create and manage both workspace-level and team-specific labels. Support for label groups and hierarchical labeling enables sophisticated issue categorization and filtering.

Tools

Issue Tools

list_issues

List issues in your Linear workspace with extensive filtering capabilities.

Parameters:

• team (optional): Filter by team name or ID
• assignee (optional): Filter by user ID, name, email, or "me" for your own issues
• state (optional): Filter by state name or ID
• label (optional): Filter by label name or ID
• project (optional): Filter by project name or ID
• cycle (optional): Filter by cycle name or ID
• parentId (optional): Filter by parent issue ID for sub-issues
• delegate (optional): Filter by agent name or ID
• query (optional): Search in issue titles and descriptions
• createdAt (optional): Filter by creation date (ISO-8601 or duration like "-P1D")
• updatedAt (optional): Filter by update date (ISO-8601 or duration)
• includeArchived (optional): Include archived issues (default: true)
• orderBy (optional): Sort by "createdAt" or "updatedAt" (default: "updatedAt")
• limit (optional): Number of results to return, max 250 (default: 50)
• after (optional): Pagination cursor for starting point
• before (optional): Pagination cursor for ending point

get_issue

Retrieve comprehensive information about a specific issue including attachments and git branch name.

Parameters:

• id (required): The issue ID

create_issue

Create a new Linear issue with full customization options.

Parameters:

• title (required): The issue title
• team (required): The team name or ID
• description (optional): Issue description in Markdown format
• assignee (optional): User ID, name, email, or "me"
• delegate (optional): Agent name, displayName, or ID
• state (optional): Issue state type, name, or ID
• priority (optional): Priority level (0=None, 1=Urgent, 2=High, 3=Normal, 4=Low)
• labels (optional): Array of label names or IDs
• project (optional): Project name or ID
• cycle (optional): Cycle name, number, or ID
• parentId (optional): Parent issue ID for sub-issues
• dueDate (optional): Due date in ISO format
• links (optional): Array of link objects with url and title properties

update_issue

Update an existing Linear issue with any combination of fields.

Parameters:

• id (required): The issue ID
• title (optional): Updated title
• description (optional): Updated description in Markdown
• assignee (optional): Updated assignee
• delegate (optional): Updated delegate
• state (optional): Updated state
• priority (optional): Updated priority
• labels (optional): Updated labels array
• project (optional): Updated project
• cycle (optional): Updated cycle
• parentId (optional): Updated parent issue
• estimate (optional): Numerical estimate value
• dueDate (optional): Updated due date
• links (optional): Updated links array

Comment Tools

list_comments

List all comments for a specific Linear issue.

Parameters:

• issueId (required): The issue ID

create_comment

Create a comment on an issue, with support for threaded replies.

Parameters:

• issueId (required): The issue ID
• body (required): Comment content in Markdown format
• parentId (optional): Parent comment ID for threaded replies

Status Tools

list_issue_statuses

List all available issue statuses for a team.

Parameters:

• team (required): The team name or ID

get_issue_status

Retrieve detailed information about a specific issue status.

Parameters:

• team (required): The team name or ID
• id (required): The status ID
• name (required): The status name

Label Tools

list_issue_labels

List available issue labels in your workspace or for a specific team.

Parameters:

• team (optional): Filter by team name or ID
• name (optional): Filter by label name
• orderBy (optional): Sort by "createdAt" or "updatedAt" (default: "updatedAt")
• limit (optional): Number of results, max 250 (default: 50)
• after (optional): Pagination cursor
• before (optional): Pagination cursor

create_issue_label

Create a new issue label at workspace or team level.

Parameters:

• name (required): Label name
• description (optional): Label description
• color (optional): Hex color code
• teamId (optional): Team UUID for team-specific labels
• parentId (optional): Parent label UUID for label groups
• isGroup (optional): Whether this is a label group (default: false)

list_project_labels

List available project labels in your workspace.

Parameters:

• name (optional): Filter by label name
• orderBy (optional): Sort by "createdAt" or "updatedAt" (default: "updatedAt")
• limit (optional): Number of results, max 250 (default: 50)
• after (optional): Pagination cursor
• before (optional): Pagination cursor

Project Tools

list_projects

List projects in your Linear workspace with filtering and search.

Parameters:

• team (optional): Filter by team name or ID
• state (optional): Filter by state name or ID
• member (optional): Filter by team member (User ID, name, email, or "me")
• initiative (optional): Filter by initiative name or ID
• query (optional): Search in project names
• createdAt (optional): Filter by creation date
• updatedAt (optional): Filter by update date
• includeArchived (optional): Include archived projects (default: false)
• orderBy (optional): Sort by "createdAt" or "updatedAt" (default: "updatedAt")
• limit (optional): Number of results, max 250 (default: 50)
• after (optional): Pagination cursor
• before (optional): Pagination cursor

get_project

Retrieve detailed information about a specific project.

Parameters:

• query (required): Project ID or name

create_project

Create a new project in Linear.

Parameters:

• name (required): Descriptive project name
• team (required): Team name or ID
• description (optional): Full project description in Markdown
• summary (optional): Concise plaintext summary (max 255 characters)
• lead (optional): Project lead (User ID, name, email, or "me")
• state (optional): Project state
• labels (optional): Array of label names or IDs
• startDate (optional): Start date in ISO format
• targetDate (optional): Target completion date in ISO format

update_project

Update an existing Linear project.

Parameters:

• id (required): Project ID
• name (optional): Updated name
• description (optional): Updated description
• summary (optional): Updated summary
• lead (optional): Updated project lead
• state (optional): Updated state
• labels (optional): Updated labels
• startDate (optional): Updated start date
• targetDate (optional): Updated target date

Team Tools

list_teams

List teams in your Linear workspace.

Parameters:

• query (optional): Search query for team names
• createdAt (optional): Filter by creation date
• updatedAt (optional): Filter by update date
• includeArchived (optional): Include archived teams (default: false)
• orderBy (optional): Sort by "createdAt" or "updatedAt" (default: "updatedAt")
• limit (optional): Number of results, max 250 (default: 50)
• after (optional): Pagination cursor
• before (optional): Pagination cursor

get_team

Retrieve detailed information about a specific team.

Parameters:

• query (required): Team UUID, key, or name

Cycle Tools

list_cycles

Retrieve cycle information for sprint planning.

Parameters:

• teamId (required): The team ID
• type (optional): Retrieve "current", "previous", "next", or all cycles

Document Tools

list_documents

List documents in your Linear workspace with filtering and search.

Parameters:

• query (optional): Search query for document content
• creatorId (optional): Filter by creator ID
• projectId (optional): Filter by project ID
• initiativeId (optional): Filter by initiative ID
• createdAt (optional): Filter by creation date
• updatedAt (optional): Filter by update date
• includeArchived (optional): Include archived documents (default: false)
• orderBy (optional): Sort by "createdAt" or "updatedAt" (default: "updatedAt")
• limit (optional): Number of results, max 250 (default: 50)
• after (optional): Pagination cursor
• before (optional): Pagination cursor

get_document

Retrieve a specific Linear document.

Parameters:

• id (required): Document ID or slug

User Tools

list_users

Retrieve users in your Linear workspace.

Parameters:

• query (optional): Filter by name or email

get_user

Retrieve detailed information about a specific user.

Parameters:

• query (required): User ID, name, email, or "me"

Documentation Tools

search_documentation

Search Linear's official documentation to learn about features and best practices.

Parameters:

• query (required): Search query
• page (optional): Page number for pagination (default: 0)

Use Cases

This MCP server enables a wide range of automation and integration scenarios:

• Personal Task Management: Quickly list and update your assigned issues using the "me" assignee filter
• Sprint Planning: Create cycles, assign issues, and track progress across team iterations
• Automated Workflows: Trigger issue creation from external events, automatically assign issues based on labels or content
• Reporting: Extract issue and project data for custom dashboards and analytics
• Documentation: Maintain technical documentation alongside your project work
• Team Coordination: Create projects, manage team assignments, and track cross-functional initiatives
• Development Integration: Retrieve git branch names and manage issue lifecycle in sync with your development workflow

All tools support Linear's flexible identifier system, allowing you to reference entities by ID, name, or other natural identifiers, making the API intuitive and easy to use.