Linear MCP Server

A comprehensive Model Context Protocol (MCP) server that provides seamless integration with Linear's project management platform. This server enables AI assistants and automation tools to interact with Linear's full suite of features, including issues, projects, documents, teams, and more, all through a unified interface.

Overview

The Linear MCP Server bridges the gap between AI-powered workflows and Linear's powerful project management capabilities. Whether you're managing sprint cycles, tracking issues, collaborating on documents, or organizing team projects, this server provides the tools needed to automate and enhance your Linear workflow. With support for both read and write operations, you can query your workspace data, create and update issues, manage projects, and maintain your team's documentation—all programmatically.

Tools

Issue Management

list_issues

Retrieve issues from 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
• delegate (optional): Filter by agent name or ID
• parentId (optional): Filter by parent issue ID for sub-issues
• query (optional): Search within issue titles and descriptions
• createdAt (optional): Return issues created on or after this ISO-8601 date-time or duration (e.g., -P1D for last day)
• updatedAt (optional): Return issues updated on or after this ISO-8601 date-time or duration
• orderBy (optional): Sort by "createdAt" or "updatedAt" (default: "updatedAt")
• limit (optional): Number of results to return, maximum 250 (default: 50)
• before (optional): ID to end pagination at
• after (optional): ID to start pagination from
• includeArchived (optional): Include archived issues (default: true)

get_issue

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

Parameters:

• id (required): The issue ID

create_issue

Create a new issue in Linear with full customization options.

Parameters:

• title (required): The issue title
• team (required): Team name or ID
• description (optional): Issue description in Markdown format
• assignee (optional): User ID, name, email, or "me"
• state (optional): Issue state type, name, or ID
• priority (optional): Priority level (0=No priority, 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 creating sub-issues
• delegate (optional): Agent name, displayName, or ID
• dueDate (optional): Due date in ISO format
• links (optional): Array of link objects with url and title properties

update_issue

Modify an existing Linear issue.

Parameters:

• id (required): The issue ID
• title (optional): Updated title
• description (optional): Updated description in Markdown
• assignee (optional): User ID, name, email, or "me"
• state (optional): Issue state type, name, or ID
• priority (optional): Priority level (0-4)
• 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
• delegate (optional): Agent name, displayName, or ID
• estimate (optional): Numerical estimate value
• dueDate (optional): Due date in ISO format
• links (optional): Array of link objects with url and title properties

list_issue_statuses

Retrieve all available issue statuses for a team.

Parameters:

• team (required): Team name or ID

get_issue_status

Get detailed information about a specific issue status.

Parameters:

• team (required): Team name or ID
• id (required): Status ID
• name (required): Status name

Comments

list_comments

Retrieve all comments associated with a specific issue.

Parameters:

• issueId (required): The issue ID

create_comment

Add a comment to an issue, with optional reply threading.

Parameters:

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

Labels

list_issue_labels

Retrieve available labels in your workspace or specific team.

Parameters:

• team (optional): Team name or ID
• name (optional): Filter by label name
• orderBy (optional): Sort by "createdAt" or "updatedAt" (default: "updatedAt")
• limit (optional): Number of results, maximum 250 (default: 50)
• before (optional): ID to end pagination at
• after (optional): ID to start pagination from

create_issue_label

Create a new label for categorizing issues.

Parameters:

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

Projects

list_projects

Browse projects in your workspace with comprehensive filtering.

Parameters:

• team (optional): Team name or ID
• state (optional): State name or ID
• member (optional): User ID, name, email, or "me"
• initiative (optional): Initiative name or ID
• query (optional): Search project names
• createdAt (optional): Filter by creation date (ISO-8601 or duration)
• updatedAt (optional): Filter by update date (ISO-8601 or duration)
• orderBy (optional): Sort by "createdAt" or "updatedAt" (default: "updatedAt")
• limit (optional): Number of results, maximum 250 (default: 50)
• before (optional): ID to end pagination at
• after (optional): ID to start pagination from
• includeArchived (optional): Include archived projects (default: false)

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 description in Markdown
• summary (optional): Concise plaintext summary (max 255 characters)
• state (optional): Project state
• lead (optional): User ID, name, email, or "me"
• 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

Modify an existing project's details.

Parameters:

• id (required): Project ID
• name (optional): Updated name
• description (optional): Updated description in Markdown
• summary (optional): Updated summary (max 255 characters)
• state (optional): Project state
• lead (optional): User ID, name, email, or "me"
• labels (optional): Array of label names or IDs
• startDate (optional): Start date in ISO format
• targetDate (optional): Target date in ISO format

list_project_labels

View all 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, maximum 250 (default: 50)
• before (optional): ID to end pagination at
• after (optional): ID to start pagination from

Documents

list_documents

Browse documentation across your Linear workspace.

Parameters:

• query (optional): Search query
• creatorId (optional): Filter by creator ID
• projectId (optional): Filter by project ID
• initiativeId (optional): Filter by initiative ID
• createdAt (optional): Filter by creation date (ISO-8601 or duration)
• updatedAt (optional): Filter by update date (ISO-8601 or duration)
• orderBy (optional): Sort by "createdAt" or "updatedAt" (default: "updatedAt")
• limit (optional): Number of results, maximum 250 (default: 50)
• before (optional): ID to end pagination at
• after (optional): ID to start pagination from
• includeArchived (optional): Include archived documents (default: false)

get_document

Retrieve a specific document's content and metadata.

Parameters:

• id (required): Document ID or slug

Cycles

list_cycles

Access sprint cycles for a specific team.

Parameters:

• teamId (required): Team ID
• type (optional): Filter by "current", "previous", or "next" cycle (omit for all cycles)

Teams

list_teams

Retrieve all teams in your workspace.

Parameters:

• query (optional): Search query
• createdAt (optional): Filter by creation date (ISO-8601 or duration)
• updatedAt (optional): Filter by update date (ISO-8601 or duration)
• orderBy (optional): Sort by "createdAt" or "updatedAt" (default: "updatedAt")
• limit (optional): Number of results, maximum 250 (default: 50)
• before (optional): ID to end pagination at
• after (optional): ID to start pagination from
• includeArchived (optional): Include archived teams (default: false)

get_team

Get detailed information about a specific team.

Parameters:

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

Users

list_users

Browse users in your Linear workspace.

Parameters:

• query (optional): Filter by name or email

get_user

Retrieve details about a specific user.

Parameters:

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

Documentation Search

search_documentation

Search Linear's official documentation for features and usage guidance.

Parameters:

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

Features and Capabilities

Comprehensive Issue Tracking

Manage your entire issue lifecycle with full CRUD operations. Search and filter issues using multiple criteria including assignees, labels, projects, cycles, and custom date ranges. Support for sub-issues and parent-child relationships enables complex task hierarchies.

Project Management

Create and maintain projects with rich metadata including descriptions, summaries, team assignments, and timeline tracking. Filter projects by team, state, members, initiatives, and temporal ranges to maintain visibility across your organization.

Collaboration Tools

Engage in threaded discussions with comment creation and listing capabilities. Support for Markdown formatting ensures rich, well-structured communication directly within your issues.

Workspace Organization

Navigate your Linear workspace structure with team and user management tools. Discover available teams, understand their configurations, and identify workspace members for effective collaboration.

Flexible Labeling System

Organize issues and projects with a hierarchical labeling system. Create workspace-wide or team-specific labels, establish label groups, and maintain consistent categorization across your work.

Sprint Planning

Access cycle information to align work with your team's sprint cadence. Query current, previous, and upcoming cycles to maintain clear temporal boundaries for your planning.

Documentation Management

Store and retrieve project documentation with full search capabilities. Filter documents by creator, project, initiative, and temporal criteria to maintain your team's knowledge base.

Integrated Help

Access Linear's official documentation directly through the search_documentation tool, enabling in-context learning about platform features and best practices.

Read-Only Optimizations

Many tools are marked with read-only and idempotent hints, indicating safe operations that can be cached or retried without side effects, enabling efficient data retrieval patterns.

Use Cases

The Linear MCP Server excels in scenarios requiring programmatic interaction with Linear's platform. Automate issue creation from external sources, synchronize project status across tools, generate reports on team velocity and progress, or build custom dashboards that aggregate Linear data with other systems. AI assistants can leverage this server to help teams manage their work, answer questions about project status, and streamline common workflows like creating issues from meeting notes or updating project timelines based on progress reports.