MCP cover image
See in Github
2025-04-02

MCP server that enables AI assistants to interact with Linear project management system through natural language, allowing users to retrieve, create, and update issues, projects, and teams.

4

Github Watches

3

Github Forks

43

Github Stars

Linear App Icon

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

mcp-linear image

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:
npx -y @smithery/cli install @tacticlaunch/mcp-linear --client cursor
  • To install MCP Linear for Claude Desktop:
npx -y @smithery/cli install @tacticlaunch/mcp-linear --client claude

Manual Configuration

Add the following to your MCP settings file:

{
  "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
# 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:

mcp-linear --token YOUR_LINEAR_API_TOKEN

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

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.

相关推荐

  • NiKole Maxwell
  • I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

  • Bora Yalcin
  • Evaluator for marketplace product descriptions, checks for relevancy and keyword stuffing.

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • apappascs
  • Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.

  • ShrimpingIt
  • Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx

  • modelcontextprotocol
  • Model Context Protocol Servers

  • Mintplex-Labs
  • The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.

  • huahuayu
  • A unified API gateway for integrating multiple etherscan-like blockchain explorer APIs with Model Context Protocol (MCP) support for AI assistants.

    Reviews

    5 (1)
    Avatar
    user_jLakOIM3
    2025-04-16

    I recently started using mcp-linear by tacticlaunch for my linear programming projects, and it has been a game-changer! The library is intuitive and easy to integrate, with robust documentation available on its GitHub page. It provides a seamless way to solve optimization problems, and the performance is remarkable. Highly recommend it for anyone in need of efficient linear programming tools!