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

Authentication

MCP Linear now uses Nango for secure authentication. You'll need to configure the following environment variables:

NANGO_CONNECTION_ID: Your connection ID from Nango
NANGO_INTEGRATION_ID: Your integration ID from Nango
NANGO_BASE_URL: The base URL for Nango API (typically https://api.nango.dev)
NANGO_SECRET_KEY: Your secret key from Nango

Fallback Authentication

If Nango is not configured, the system will fall back to using a Linear API token passed via the --token command line argument.

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": {
        "NANGO_CONNECTION_ID": "your_connection_id",
        "NANGO_INTEGRATION_ID": "your_integration_id",
        "NANGO_BASE_URL": "https://api.nango.dev",
        "NANGO_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

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
Nango configuration or 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

Create a .env file with your Nango configuration:

NANGO_CONNECTION_ID=your_connection_id
NANGO_INTEGRATION_ID=your_integration_id
NANGO_BASE_URL=https://api.nango.dev
NANGO_SECRET_KEY=your_secret_key

Then run the server:

mcp-linear

Or use the fallback method with a Linear API token:

mcp-linear --token YOUR_LINEAR_API_TOKEN

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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that enables AI assistants to interact with Linear project management systems, allowing users to create, update, and manage issues, projects, teams, and comments through natural language.

Related MCP Servers

Linear MCP Server
vinayak-mehta
A
security
A
license
A
quality
A Model Context Protocol server that integrates with Linear, enabling AI assistants to create, update, search, and comment on issues for project management and issue tracking.
Last updated -
5
6
Python
Apache 2.0
MCP Linear App
zalab-inc
-
security
F
license
-
quality
A server that enables AI assistants to interact with Linear's project management tools through the Model Context Protocol, supporting features like searching, creating, and updating issues, adding comments, and retrieving user profiles and team information.
Last updated -
TypeScript
Linear MCP Server
emmett-deen
-
security
F
license
-
quality
A Model Context Protocol server implementation that enables AI assistants to interact with Linear project management systems, allowing them to create, retrieve, and modify data related to issues, projects, teams, and users.
Last updated -
71
3
TypeScript
MCP Toolkit
zxfgds
-
security
F
license
-
quality
A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
Last updated -
6
1
TypeScript

View all related MCP servers

MCP Linear

MCP Linear

Features

Example prompts

Installation

Authentication

Fallback Authentication

Installing via Smithery (Recommended)

Manual Configuration

Client-Specific Configuration Locations

Manual run

Running the Server

Available Tools

Development

Links

License

Related MCP Servers

Linear MCP Server

MCP Linear App

Linear MCP Server

MCP Toolkit

New MCP Servers

MCP directory API