Linear MCP Server 0yc

🚀 Linear MCP Server

The Linear MCP Server is a tool designed for interacting with the Linear platform. It offers a range of functions, such as creating, updating, and retrieving issues, cycles, projects, and other related entities.

🚀 Quick Start

The Linear MCP Server serves as a bridge to the Linear platform, enabling seamless interaction with various entities.

✨ Features

Issue Management

• Create issues
• Update issues
• Retrieve a single issue
• Retrieve all issues

Cycle Management

• Create cycles
• Update cycles
• Retrieve a single cycle
• Retrieve all cycles

Project Management

• Create projects
• Update projects
• Retrieve a single project
• Retrieve all projects

📦 Installation

Prerequisites

• Node.js (version 14 or higher)
• npm (version 6 or higher)

Download the Code

git clone [repository-url]
cd linear-mcp-server

Install Dependencies

npm install

📚 Documentation

Configuration

Create a .env file and add the following content:

NEXT_PUBLIC_LINEAR_CLIENT_ID=your_client_id
NEXT_PUBLIC_LINEAR_CLIENT_SECRET=your_client_secret
NEXT_PUBLIC_LINEAR_REDIRECT_URI=your_redirect_uri
NEXT_PUBLIC_LINEAR_ENVIRONMENT=production

Usage Instructions

Create an Issue

npm run create-issue -- --title "问题标题" --description "问题描述" --assigneeId user-id --stateId state-id --priority 0 --estimate 1 --cycleId cycle-id --projectId project-id --labelIds label-id,label-id2

Update an Issue

npm run update-issue -- --issueId issue-id --title "新标题" --description "新描述" --assigneeId user-id --stateId state-id --priority 0 --estimate 1 --cycleId cycle-id --projectId project-id --labelIds label-id,label-id2

Debugging

If you encounter issues during use, refer to the following debugging steps:

• Check if the environment variables are set correctly.
• Ensure that the Linear API is running normally (you can visit status.linear.app).
• Check the server logs for more error information.

Development

Install Dependencies

npm install

Start the Development Server

npm run dev

Security Precautions

⚠️ Important Note

• Do not commit sensitive tokens. The .env file and other files containing tokens should be excluded from version control.
• Use environment variables. Always use environment variables in the MCP configuration instead of hard - coding tokens.
• Limit permissions. When creating a Linear OAuth application, only grant the necessary permissions.
• Rotate tokens regularly. Generate new tokens periodically and update the configuration.

📄 License

This project is under the MIT License.