Linear MCP Server

🚀 Linear MCP Server

A Model Context Protocol (MCP) server implementing a linear GraphQL API, enabling AI assistants to interact with the Linear project management system.

🚀 Quick Start

The Linear MCP Server allows AI assistants to seamlessly interact with the Linear project management system. By integrating the MCP protocol, users can easily manage projects, tasks, and team members.

✨ Features

• Access the Linear GraphQL API through MCP tools.
• Authenticate using a Linear API key.
• Retrieve and modify data related to users, teams, projects, and issues.
• Create, update, and comment on issues.
• Add and remove labels.
• Create projects.
• Comprehensive tool documentation.

📦 Installation

Via Smithery

1. Visit the Smithery website and log in.
2. Find the Linear MCP Server in the "Add Server" section.
3. Complete the installation and configuration as prompted.

Manual Installation

npm install --save @emmett-deen/linear-mcp-server

📚 Configuration

Create a .env file and add the following content:

PORT=8080  # Optional, default is 3000
API_KEY=your_api_key_here

🚀 Starting the Server

node index.js

💻 Usage Examples

Example Tool: Creating an Issue

const { createIssue } = require('@emmett-deen/linear-mcp-server');

createIssue({
  title: 'Fix login issue',
  description: 'This issue needs to be resolved by Friday.',
  assignee: 'john.smith@example.com',
  labels: ['bug', 'high-priority']
});

Example Usage with Claude Desktop

Once connected to Claude Desktop, you can use the following prompts:

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

📚 Prerequisites

• Node.js version 12 or higher.
• npm version 6 or higher.
• A Linear API key.

📦 Installation Instructions

Installing Dependencies

npm install

Running the Server

node index.js --token your_api_token_here

🛠️ Configuration on Claude Desktop

1. Open the settings in Claude Desktop.
2. Add a new connection and select the Linear MCP Server as the provider.
3. Enter the server address and API key.

🔧 Development

Setting up the Development Environment

git clone https://github.com/yourusername/linear-mcp-server.git
cd linear-mcp-server
npm install
npm run dev -- --token your_api_token_here

Extending the Server

1. Refer to the implementation guide in the TOOLS.md document.
2. Ensure that you follow the existing code structure in the src directory.
3. Update the documentation to reflect the changes.

🤝 Contribution and Development

Setting up the Development Environment

git clone https://github.com/yourusername/linear-mcp-server.git
cd linear-mcp-server
npm install
npm run dev

Publishing to npm

1. Update the version in package.json:

npm version patch  # or minor, or major

2. Build the project:

npm run build

3. Ensure you are logged in to npm:

npm login

4. Publish to npm:

npm publish --access public

5. For the Smithery registry, contact the Smithery team to list the server in the directory.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.