Mo - Linear Task Management for Cursor IDE

by ztfo

1 175 downloads Not rated yet ISC
GitHub

About

Linear<>Cursor MCP Server for AI powered project management

Details

License
ISC

Explore

- Task Management: Create, update, and track tasks directly in Cursor
- Context-Awareness: Create tasks from code selections or current file context
- Protocol Version Handling: Support for Cursor MCP protocol version compatibility
- Rich Responses: Markdown-formatted responses with action buttons
- Linear Integration: Sync tasks with Linear for team collaboration
- Authentication with secure credential storage
- Bidirectional synchronization between local tasks and Linear issues
- Filtering and querying Linear issues
- Support for projects, teams, and workflow states
- Chat Integration: Use Linear tools directly in Claude chat within Cursor
- Webhook Support: Register webhooks for real-time issue updates (optional)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mo - Linear Task Management for Cursor IDE
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- Cursor IDE
- Node.js 16+
- Linear account (for Linear integration)

The package is available on npm and can be installed globally:

npm install -g mo-linear-mcp

You can also use it directly without installation via npx:

npx mo-linear-mcp

Visit the package on npm: mo-linear-mcp

1. Clone this repository:

   git clone https://github.com/yourusername/mo-linear-mcp.git
   cd mo-linear-mcp
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. Run in development mode:

   npm run dev
   

To use Mo in Cursor, you need to configure it in the MCP settings. Here's an example configuration:

{
  "version": "0.1",
  "mcps": {
    "mo-linear-mcp-dev": {
      "name": "Mo Linear MCP (Dev)",
      "description": "Linear Task Management for Cursor IDE - Development Mode",
      "command": "npm",
      "args": ["run", "dev"],
      "cwd": "/path/to/your/mo-linear-mcp",
      "enabled": true
    },
    "linear": {
      "name": "Linear",
      "description": "Linear Task Management for Cursor",
      "command": "npx",
      "args": ["-y", "mo-linear-mcp"],
      "enabled": true
    }
  }
}

To access the MCP configuration in Cursor:

1. Open Cursor IDE
2. Go to Settings → Extensions → MCP Servers
3. Click "Edit MCP Config" and paste the configuration above
4. Adjust the "cwd" path to match your local repository path (for development mode)

To use the Linear integration, you need to authenticate with your Linear API key:

/mo linear-auth key:your_linear_api_key

Or in chat mode:

@Linear linear_auth key:your_linear_api_key

You can get your Linear API key from Linear's settings page.

Mo can also be used directly in the Claude chat interface with the following syntax:

@Linear linear_auth key:your_api_key
@Linear linear_status
@Linear linear_teams
@Linear linear_projects team:team-id
@Linear linear_issues team:team-id
@Linear linear_sync

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mo - linear task management for cursor ide": {
            "mo": {
                "command": "npx",
                "args": [
                    "mo-linear-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "mo": {
        "command": "npx",
        "args": [
            "mo-linear-mcp"
        ]
    }
}

Mo is a task management tool designed as a Model Context Protocol (MCP) server for Cursor IDE. It provides seamless integration with Linear for issue tracking and task management, allowing developers to manage their workflow directly from within Cursor.

npm version
License: ISC

Project Status

- Phase 1: ✅ Completed (March 21, 2024) - Core infrastructure and basic task management
- Phase 2: ✅ Completed (April 5, 2024) - Linear integration and chat tool support
- Phase 3: 🔄 In Progress - AI enhancement features
- Phase 4: 📅 Planned - Advanced features and polish

See the Project Plan for more details on the project timeline and phases.

Features

- Task Management: Create, update, and track tasks directly in Cursor
- Context-Awareness: Create tasks from code selections or current file context
- Protocol Version Handling: Support for Cursor MCP protocol version compatibility
- Rich Responses: Markdown-formatted responses with action buttons
- Linear Integration: Sync tasks with Linear for team collaboration
- Authentication with secure credential storage
- Bidirectional synchronization between local tasks and Linear issues
- Filtering and querying Linear issues
- Support for projects, teams, and workflow states
- Chat Integration: Use Linear tools directly in Claude chat within Cursor
- Webhook Support: Register webhooks for real-time issue updates (optional)

Installation

Prerequisites

- Cursor IDE
- Node.js 16+
- Linear account (for Linear integration)

Option 1: Install From npm (Recommended)

The package is available on npm and can be installed globally:

npm install -g mo-linear-mcp

You can also use it directly without installation via npx:

npx mo-linear-mcp

Visit the package on npm: mo-linear-mcp

Option 2: Local Development Setup

1. Clone this repository:

   git clone https://github.com/yourusername/mo-linear-mcp.git
   cd mo-linear-mcp
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. Run in development mode:

   npm run dev
   

Cursor MCP Configuration

To use Mo in Cursor, you need to configure it in the MCP settings. Here's an example configuration:

{
  "version": "0.1",
  "mcps": {
    "mo-linear-mcp-dev": {
      "name": "Mo Linear MCP (Dev)",
      "description": "Linear Task Management for Cursor IDE - Development Mode",
      "command": "npm",
      "args": ["run", "dev"],
      "cwd": "/path/to/your/mo-linear-mcp",
      "enabled": true
    },
    "linear": {
      "name": "Linear",
      "description": "Linear Task Management for Cursor",
      "command": "npx",
      "args": ["-y", "mo-linear-mcp"],
      "enabled": true
    }
  }
}

To access the MCP configuration in Cursor:

1. Open Cursor IDE
2. Go to Settings → Extensions → MCP Servers
3. Click "Edit MCP Config" and paste the configuration above
4. Adjust the "cwd" path to match your local repository path (for development mode)

Development and Publishing

Local Development

For rapid development and testing:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.