https://github.com/tacticlaunch/mcp-linear
MCP server that enables AI assistants to interact with Linear project management system through natural language, allowing users to retrieve, create, and update issues, projects, and teams.
https://github.com/tacticlaunch/mcp-linear
claude cursor linear mcp
Last synced: 16 days ago
JSON representation
MCP server that enables AI assistants to interact with Linear project management system through natural language, allowing users to retrieve, create, and update issues, projects, and teams.
- Host: GitHub
- URL: https://github.com/tacticlaunch/mcp-linear
- Owner: tacticlaunch
- License: mit
- Created: 2025-03-23T15:27:19.000Z (24 days ago)
- Default Branch: main
- Last Pushed: 2025-03-30T21:54:34.000Z (17 days ago)
- Last Synced: 2025-03-30T22:28:28.778Z (17 days ago)
- Topics: claude, cursor, linear, mcp
- Language: TypeScript
- Homepage:
- Size: 729 KB
- Stars: 19
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-mcp-servers - Linear - Project management platform integration (👥 Community Contributions / Productivity & Knowledge Management)
- awesome-mcp-servers - Linear - Project management platform integration (👥 Community Contributions / Productivity & Knowledge Management)
- Awesome-MCP-Servers-directory - Linear - Integrates with Linear project management systems (Other Tools and Integrations)
- awesome-mcp-servers - Linear MCP - MCP server that enables AI assistants to interact with Linear project management system through natural language, allowing users to retrieve, create, and update issues, projects, and teams. (Table of Contents / Workflow Automation)
- awesome-mcp-servers - Linear MCP - MCP server that enables AI assistants to interact with Linear project management system through natural language, allowing users to retrieve, create, and update issues, projects, and teams. (Table of Contents / Workflow Automation)
- awesome-mcp-servers - Linear - Integrates with Linear project management systems. (Community Servers)
README
# MCP Linear
A Model Context Protocol (MCP) server implementation for the Linear GraphQL API that enables AI assistants to interact with Linear project management systems.
[](https://www.npmjs.com/package/@tacticlaunch/mcp-linear)
[](https://smithery.ai/server/@tacticlaunch/mcp-linear)
## Features
MCP Linear bridges the gap between AI assistant and Linear (project management tool) by implementing the MCP protocol. This allows to:
- Retrieve issues, projects, teams, and other data from Linear
- Create and update issues
- Change issue status
- Assign issues to team members
- Add comments
- Create projects and teams
## Example prompts
Once connected, you can use prompts like:
- "Show me all my Linear 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'"
## Installation
### Getting Your Linear API Token
To use MCP Linear, you'll need a Linear API token. Here's how to get one:
1. Log in to your Linear account at [linear.app](https://linear.app)
2. Click on 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!
### Installing via [Smithery](https://smithery.ai/server/@tacticlaunch/mcp-linear) (Recommended)
- To install MCP Linear for Cursor:
```bash
npx -y @smithery/cli install @tacticlaunch/mcp-linear --client cursor
```
- To install MCP Linear for Claude Desktop:
```bash
npx -y @smithery/cli install @tacticlaunch/mcp-linear --client claude
```
### Manual Configuration
Add the following to your MCP settings file:
```json
{
"mcpServers": {
"linear": {
"command": "npx",
"args": ["-y", "@tacticlaunch/mcp-linear"],
"env": {
"LINEAR_API_TOKEN": ""
}
}
}
}
```
#### Client-Specific Configuration Locations
- Cursor: `~/.cursor/mcp.json`
- Claude Desktop: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Claude VSCode Extension: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
- GoMCP: `~/.config/gomcp/config.yaml`
### Manual run
Prerequisites
- Node.js (v18+)
- NPM or Yarn
- Linear API token
```bash
# Install globally
npm install -g @tacticlaunch/mcp-linear
# Or clone and install locally
git clone https://github.com/tacticlaunch/mcp-linear.git
cd mcp-linear
npm install
npm link # Makes the package available globally
```
#### Running the Server
Run the server with your Linear API token:
```bash
mcp-linear --token YOUR_LINEAR_API_TOKEN
```
Or set the token in your environment and run without arguments:
```bash
export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
mcp-linear
```
## Available Tools
See [TOOLS.md](https://github.com/tacticlaunch/mcp-linear/blob/main/TOOLS.md) for a complete list of available tools and planned features.
## Development
See [DEVELOPMENT.md](https://github.com/tacticlaunch/mcp-linear/blob/main/DEVELOPMENT.md) for more information on how to develop locally.
## Links
[tacticlaunch/cursor-memory-bank](https://github.com/tacticlaunch/cursor-memory-bank) - If you are a developer seeking to enhance your workflow with Cursor, consider giving it a try.
## License
This project is licensed under the MIT License - see the LICENSE file for details.