MCP Linear

MCP Linear

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

View on GitHub
117
Stars
23
Forks
117
Watchers
5
Issues
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.

Key Features

Provides a Model Context Protocol (MCP) server for Linear
Allows AI assistants to retrieve issues, projects, teams, and data from Linear
Enables creation and updating of issues
Supports changing issue status and assignment
Facilitates adding comments to issues
Allows creation of projects and teams programmatically
Easy installation via Smithery or manual configuration
Works with multiple AI clients (e.g., Cursor, Claude Desktop, VSCode extension, GoMCP)
Supports authentication with Linear using API tokens
Comprehensive tool listing and planned feature documentation

Use Cases

Allowing AI assistants to display a user’s open Linear issues
Creating new tasks or issues in Linear via natural language prompts
Automatically updating issue status based on project progress
Assigning team members to issues without leaving an AI assistant interface
Adding comments to issues through conversational AI
Initiating new projects and teams directly from an AI client
Integrating Linear management into custom AI-powered workflows
Providing summarized project status or reports upon request
Automating repetitive project management actions in Linear
Enhancing collaboration by bridging project tracking with conversational agents

README

MCP Linear

A Model Context Protocol (MCP) server implementation for the Linear GraphQL API that enables AI assistants to interact with Linear project management systems.

MCP Linear npm version smithery badge

Features

MCP Linear bridges the gap between AI assistant and Linear (project management tool) by implementing the MCP protocol. This allows to:

  • Retrieve issues, projects, teams, and other data from Linear
  • Create and update issues
  • Change issue status
  • Assign issues to team members
  • Add comments
  • Create projects and teams

Example prompts

Once connected, you can use prompts like:

  • "Show me all my Linear issues"
  • "Create a new issue titled 'Fix login bug' in the Frontend team"
  • "Change the status of issue FE-123 to 'In Progress'"
  • "Assign issue BE-456 to John Smith"
  • "Add a comment to issue UI-789: 'This needs to be fixed by Friday'"

Installation

Getting Your Linear API Token

To use MCP Linear, you'll need a Linear API token. Here's how to get one:

  1. Log in to your Linear account at linear.app
  2. Click on organization avatar (in the top-left corner)
  3. Select Settings
  4. Navigate to Security & access in the left sidebar
  5. Under Personal API Keys click New API Key
  6. Give your key a name (e.g., MCP Linear Integration)
  7. Copy the generated API token and store it securely - you won't be able to see it again!

Installing via Smithery (Recommended)

  • To install MCP Linear for Cursor:
bash
npx -y @smithery/cli install @tacticlaunch/mcp-linear --client cursor
  • To install MCP Linear for Claude Desktop:
bash
npx -y @smithery/cli install @tacticlaunch/mcp-linear --client claude

Manual Configuration

Add the following to your MCP settings file:

json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@tacticlaunch/mcp-linear"],
      "env": {
        "LINEAR_API_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Client-Specific Configuration Locations

  • Cursor: ~/.cursor/mcp.json
  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Claude VSCode Extension: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • GoMCP: ~/.config/gomcp/config.yaml

Manual run

Prerequisites

  • Node.js (v18+)
  • NPM or Yarn
  • Linear API token
bash
# Install globally
npm install -g @tacticlaunch/mcp-linear

# Or clone and install locally
git clone https://github.com/tacticlaunch/mcp-linear.git
cd mcp-linear
npm install
npm link  # Makes the package available globally

Running the Server

Run the server with your Linear API token:

bash
mcp-linear --token YOUR_LINEAR_API_TOKEN

Or set the token in your environment and run without arguments:

bash
export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
mcp-linear

Available Tools

See TOOLS.md for a complete list of available tools and planned features.

Development

See DEVELOPMENT.md for more information on how to develop locally.

Links

tacticlaunch/cursor-memory-bank - If you are a developer seeking to enhance your workflow with Cursor, consider giving it a try.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Star History

Star History Chart

Repository Owner

tacticlaunch
tacticlaunch

Organization

Repository Details

Language TypeScript
Default Branch main
Size 898 KB
Contributors 6
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

TypeScript
97.91%
JavaScript
1.71%
Dockerfile
0.38%

Tags

project-management issue-tracking automation

Topics

claude cursor linear mcp

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 Manager for Claude Desktop

    MCP Manager for Claude Desktop

    A desktop app to manage Model Context Protocol (MCP) servers for Claude Desktop on MacOS.

    MCP Manager for Claude Desktop provides a user-friendly interface to manage Model Context Protocol (MCP) servers, enabling Claude to access private data, APIs, and local or remote services securely from a MacOS desktop. It facilitates rapid configuration and integration with a wide variety of MCP servers, including productivity tools, databases, and web APIs. The app runs locally to ensure data privacy and streamlines connecting Claude to new sources through simple environment and server settings management.

    • ⭐ 270
    • MCP
    • zueai/mcp-manager
  • kibitz

    kibitz

    The coding agent for professionals with MCP integration.

    kibitz is a coding agent that supports advanced AI collaboration by enabling seamless integration with Model Context Protocol (MCP) servers via WebSockets. It allows users to configure Anthropic API keys, system prompts, and custom context providers for each project, enhancing contextual understanding for coding tasks. The platform is designed for developers and professionals seeking tailored AI-driven coding workflows and provides flexible project-specific configuration.

    • ⭐ 104
    • MCP
    • nick1udwig/kibitz
  • HackMD MCP Server

    HackMD MCP Server

    MCP server connecting LLM clients to the HackMD collaborative note platform.

    HackMD MCP Server implements the Model Context Protocol (MCP) to provide a standardized interface between large language model (LLM) clients and the HackMD collaborative note service. Through HTTP and STDIO transports, it enables creation, retrieval, update, and deletion of notes, along with management of teams, user profiles, and history data. It supports deployment in both local and cloud environments, with secure API token-based authentication and configuration via environment variables or HTTP headers.

    • ⭐ 43
    • MCP
    • yuna0x0/hackmd-mcp
  • interactive-mcp

    interactive-mcp

    Enable interactive, local communication between LLMs and users via MCP.

    interactive-mcp implements a Model Context Protocol (MCP) server in Node.js/TypeScript, allowing Large Language Models (LLMs) to interact directly with users on their local machine. It exposes tools for requesting user input, sending notifications, and managing persistent command-line chat sessions, facilitating real-time communication. Designed for integration with clients like Claude Desktop and VS Code, it operates locally to access OS-level notifications and command prompts. The project is suited for interactive workflows where LLMs require user involvement or confirmation.

    • ⭐ 313
    • MCP
    • ttommyth/interactive-mcp
  • Linear MCP Server

    Linear MCP Server

    Integrate Linear issue tracking with Model Context Protocol for LLMs.

    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.

    • ⭐ 333
    • MCP
    • jerhadf/linear-mcp-server
  • 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
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results