MCP Linear

🚀 MCP Linear (Linear)

A Model Context Protocol (MCP) server that implements a Linear GraphQL API, enabling AI assistants to interact with the Linear project management tool.

✨ Features

MCP Linear bridges the gap between AI assistants and the Linear project management tool by implementing the MCP protocol. This enables the following operations:

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

💻 Usage Examples

Basic Usage

Once connected, you can use prompts similar to the following:

• "Show me all my Linear issues."
• "Create a new issue in the Frontend team with the title 'Fix login issue'."
• "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 issue must be resolved by Friday'."

📦 Installation

Obtain Your Linear API Token

Before using MCP Linear, you need a Linear API token. Here's how to get one:

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

Install Using Smithery (Recommended)

• For Cursor:

npx -y @smithery/cli install @tacticlaunch/mcp-linear --client cursor

• For Claude Desktop:

npx -y @smithery/cli install @tacticlaunch/mcp-linear --client claude

Manual Configuration

Add the following to your MCP settings file:

{
  "mcp": {
    "linear": {
      "token": "your_linear_api_token_here"
    }
  }
}

📚 Documentation

Install Dependencies

Ensure Node.js and npm are installed, then run the following command:

npm install @tacticlaunch/mcp-linear

Initialize the Project

Create a new file index.js and add the following content:

const { LinearMCP } = require('@tacticlaunch/mcp-linear');

async function main() {
    const linearMcp = new LinearMCP({
        token: 'your_linear_api_token_here'
    });

    // Get the project list
    const projects = await linearMcp.getProjects();
    console.log('Projects:', projects);

    // Create a new issue
    const newIssue = await linearMcp.createIssue({
        projectId: 'project_id',
        title: 'This is a new issue',
        description: 'This is the detailed description of the new issue'
    });
    console.log('New Issue:', newIssue);

    // Update an existing issue
    const updatedIssue = await linearMcp.updateIssue({
        issueId: 'issue_id',
        title: 'Updated issue title',
        description: 'Updated issue description'
    });
    console.log('Updated Issue:', updatedIssue);
}

main().catch(console.error);

🛠️ Tools List

• tacticlaunch/cursor-memory-bank - If you're a developer looking to enhance your workflow with Cursor, give it a try.

📄 License

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