Linear Integration MCP Server

Overview

Linear Integration connects your AI assistant to Linear's project management platform, allowing you to manage your tasks and projects through natural language commands. This integration streamlines your workflow by eliminating the need to switch between applications.

Installation

Prerequisites

Before installing the Linear Integration, you'll need to obtain a Linear API token:

1. Log in to your Linear account at linear.app
2. Click on your 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!

Installation Options

Using Smithery (Recommended)

The easiest way to install Linear Integration is through Smithery:

• 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 Installation

If you prefer to configure the integration manually, add the following to your MCP settings file:

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

Replace <YOUR_LINEAR_API_TOKEN> with the API token you generated earlier.

Client-Specific Configuration Locations

Depending on your AI assistant, the configuration file location will vary:

• Claude Desktop: ~/.config/claude-mcp/config.json
• Cursor: ~/.cursor/mcp/config.json
• Anthropic API: Refer to the API documentation for configuration details

Usage

Once the Linear Integration is installed and configured, you can interact with your Linear workspace using natural language prompts. Here are some examples of what you can do:

Viewing Information

• "Show me all my Linear issues"
• "List all projects in the Frontend team"
• "What's the status of issue FE-123?"
• "Show me all issues assigned to me"

Creating and Updating 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'"
• "Set the priority of issue FE-123 to 'High'"

Managing Projects and Teams

• "Create a new project called 'Website Redesign'"
• "Add issue FE-123 to the 'Website Redesign' project"
• "Show me all members of the Backend team"

Troubleshooting

If you encounter issues with the Linear Integration:

1. Check your API token: Ensure your Linear API token is valid and has the necessary permissions
2. Verify network connectivity: Make sure your AI assistant can connect to Linear's API
3. Check for error messages: Look for specific error messages that might indicate the problem
4. Restart the integration: Sometimes restarting your AI assistant can resolve connection issues

For persistent issues, you can check the GitHub repository for known issues or to report new ones.