Linear MCP Server

Linear MCP Server

Integrate Linear issue tracking with Model Context Protocol for LLMs.

View on GitHub Visit Website
333
Stars
60
Forks
333
Watchers
17
Issues
Linear MCP Server acts as a bridge between the Linear API and the Model Context Protocol, enabling large language models to interact programmatically with Linear's issue tracking system. It provides tools to create, update, search, and manage issues, as well as to add comments and retrieve user or team-focused issue data. Designed to integrate with platforms such as Claude Desktop, it supports seamless issue management workflows through MCP-compatible commands and resource endpoints.

Key Features

Create, update, and search Linear issues via MCP commands
Add comments to issues programmatically
Fetch issues assigned to specific users or teams
View resources like issues, teams, users, and organization contexts
Support for flexible filtering and search
Integration with Claude Desktop and Smithery CLI
Automated and manual installation options
Extensible MCP server architecture
Environment variable-based API key management
Customizable comment attribution with avatars

Use Cases

Allowing large language models to create issue tickets in Linear
Automating updating or triaging of existing Linear tasks via chat
Enabling conversational querying of project issues for users
Facilitating bulk issue searches based on filters like priority or status
Fetching a user's assigned issues for workload management
Adding contextual comments to issues from AI assistants
Integrating Linear workflows with broader DevOps toolchains
Providing project managers with automated insights via LLMs
Generating new bug reports or feature requests from user prompts
Customizing notifications and context retrieval within Linear projects

README

Linear MCP Server

npm version smithery badge

IMPORTANT NOTE: This MCP Server is now deprecated and is no longer being maintained. I recommend you use the official Linear remote MCP server here: https://linear.app/changelog/2025-05-01-mcp (https://mcp.linear.app/sse)

A Model Context Protocol server for the Linear API.

This server provides integration with Linear's issue tracking system through MCP, allowing LLMs to interact with Linear issues.

Installation

Automatic Installation

To install the Linear MCP server for Claude Desktop automatically via Smithery:

bash
npx @smithery/cli install linear-mcp-server --client claude

Manual Installation

  1. Create or get a Linear API key for your team: https://linear.app/YOUR-TEAM/settings/api

  2. Add server config to Claude Desktop:

    • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

Components

Tools

  1. linear_create_issue: Create a new Linear issues

    • Required inputs:
      • title (string): Issue title
      • teamId (string): Team ID to create issue in
    • Optional inputs:
      • description (string): Issue description (markdown supported)
      • priority (number, 0-4): Priority level (1=urgent, 4=low)
      • status (string): Initial status name

  2. linear_update_issue: Update existing issues

    • Required inputs:
      • id (string): Issue ID to update
    • Optional inputs:
      • title (string): New title
      • description (string): New description
      • priority (number, 0-4): New priority
      • status (string): New status name

  3. linear_search_issues: Search issues with flexible filtering

    • Optional inputs:
      • query (string): Text to search in title/description
      • teamId (string): Filter by team
      • status (string): Filter by status
      • assigneeId (string): Filter by assignee
      • labels (string[]): Filter by labels
      • priority (number): Filter by priority
      • limit (number, default: 10): Max results

  4. linear_get_user_issues: Get issues assigned to a user

    • Optional inputs:
      • userId (string): User ID (omit for authenticated user)
      • includeArchived (boolean): Include archived issues
      • limit (number, default: 50): Max results

  5. linear_add_comment: Add comments to issues

    • Required inputs:
      • issueId (string): Issue ID to comment on
      • body (string): Comment text (markdown supported)
    • Optional inputs:
      • createAsUser (string): Custom username
      • displayIconUrl (string): Custom avatar URL

Resources

  • linear-issue:///{issueId} - View individual issue details
  • linear-team:///{teamId}/issues - View team issues
  • linear-user:///{userId}/assigned - View user's assigned issues
  • linear-organization: - View organization info
  • linear-viewer: - View current user context

Usage examples

Some example prompts you can use with Claude Desktop to interact with Linear:

  1. "Show me all my high-priority issues" → execute the search_issues tool and/or linear-user:///{userId}/assigned to find issues assigned to you with priority 1

  2. "Based on what I've told you about this bug already, make a bug report for the authentication system" → use create_issue to create a new high-priority issue with appropriate details and status tracking

  3. "Find all in progress frontend tasks" → use search_issues to locate frontend-related issues with in progress task

  4. "Give me a summary of recent updates on the issues for mobile app development" → use search_issues to identify the relevant issue(s), then linear-issue:///{issueId} fetch the issue details and show recent activity and comments

  5. "What's the current workload for the mobile team?" → combine linear-team:///{teamId}/issues and search_issues to analyze issue distribution and priorities across the mobile team

Development

  1. Install dependencies:
bash
npm install
  1. Configure Linear API key in .env:
bash
LINEAR_API_KEY=your_api_key_here
  1. Build the server:
bash
npm run build

For development with auto-rebuild:

bash
npm run watch

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Star History

Star History Chart

Repository Owner

jerhadf
jerhadf

User

Repository Details

Language JavaScript
Default Branch main
Size 38 KB
Contributors 2
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

JavaScript
100%

Tags

issue-tracking llm-integration Task Automation devops project-management

Topics

anthropic linear mcp mcp-server model-context-protocol

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • MCP Linear

    MCP Linear

    MCP server for AI-driven control of Linear project management.

    MCP Linear is a Model Context Protocol (MCP) server implementation that enables AI assistants to interact with the Linear project management platform. It provides a bridge between AI systems and the Linear GraphQL API, allowing the retrieval and management of issues, projects, teams, and more. With MCP Linear, users can create, update, assign, and comment on Linear issues, as well as manage project and team structures directly through AI interfaces. The tool supports seamless integration via Smithery and can be configured for various AI clients like Cursor and Claude Desktop.

    • ⭐ 117
    • MCP
    • tacticlaunch/mcp-linear
  • Plane MCP Server

    Plane MCP Server

    Enables LLMs to manage Plane.so projects and issues via the Model Context Protocol.

    Plane MCP Server provides a standardized interface to connect large language models with Plane.so project management APIs. It enables LLMs to interact directly with project and issue data, supporting tasks such as listing projects, retrieving detailed information, creating and updating issues, while prioritizing user control and security. Installation is streamlined through tools like Smithery, and configuration supports multiple clients including Claude for Desktop.

    • ⭐ 32
    • MCP
    • kelvin6365/plane-mcp-server
  • GitLab MR MCP

    GitLab MR MCP

    An MCP server for AI-powered interaction with GitLab merge requests and issues.

    GitLab MR MCP implements a server for the Model Context Protocol (MCP) enabling AI agents to perform structured interactions with GitLab repositories. It provides capabilities for reading merge request and issue details, listing projects, fetching diffs and comments, and making changes such as commenting or updating titles and descriptions. Installation is supported via Smithery or manually, and integration with MCP clients and Inspector tools is documented for development and troubleshooting.

    • ⭐ 65
    • MCP
    • kopfrechner/gitlab-mr-mcp
  • Jira Communication Server MCP Server

    Jira Communication Server MCP Server

    A TypeScript-based MCP server for seamless Jira interactions

    Jira Communication Server MCP Server enables integration with Jira by exposing standardized tools for querying, creating, editing, and managing Jira issues via the Model Context Protocol. It supports a wide range of Jira operations, including executing JQL queries, managing tickets, handling attachments, assigning tickets, and interacting with Jira projects and statuses. The server is designed for use in environments supporting the MCP, such as Claude Desktop, and provides debugging utilities for MCP communication.

    • ⭐ 25
    • MCP
    • KS-GEN-AI/jira-mcp-server
  • Jira MCP

    Jira MCP

    AI-Ready Jira Server for Real-World Developer Workflows

    Jira MCP is an opinionated server implementation of the Model Context Protocol (MCP) tailored for Jira automation and integration. It provides advanced tools to manage Jira issues, sprints, development data, and project versions, reflecting workflows of real engineering and QA teams. Designed for seamless AI and tool integrations, it supports context-rich retrieval of Jira information for enhancing development transparency and automation.

    • ⭐ 69
    • MCP
    • nguyenvanduocit/jira-mcp
  • @dealx/mcp-server

    @dealx/mcp-server

    MCP server enabling LLMs to search and interact with the DealX platform.

    Implements the Model Context Protocol, providing a standardized interface for large language models to interact with the DealX platform. Supports searching for ads through structured prompts and is designed for easy integration with tools like Claude and VS Code extensions. Flexible configuration options are available for environment variables, logging, and deployment. Extensible architecture supports future feature additions beyond ad search.

    • ⭐ 0
    • MCP
    • DealExpress/mcp-server
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results