Skip to main content
Glama

mcp-linear

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

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!
  • 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.

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.

-
security - not tested
-
license - not tested
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

mcp-linear

  1. Features
    1. Example prompts
      1. Installation
        1. Getting Your Linear API Token
        2. Installing via Smithery (Recommended)
        3. Manual Configuration
        4. Manual run
      2. Available Tools
        1. Development
          1. Links
            1. License

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                dbt-mcp
                Last updated -
                16
                226
                Python
                Apache 2.0
                • Linux
                • Apple
              • A
                security
                A
                license
                A
                quality
                interactive-mcp
                Last updated -
                5
                116
                46
                TypeScript
                MIT License
                • Apple
                • Linux

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/ThinkFar/mcp-linear'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server