Linear MCP Server
Overview
Linear MCP Server is a server designed to integrate with the Linear API for issue tracking, enabling LLMs (Large Language Models) to interact with Linear issues using the Model Context Protocol (MCP).
To use the Linear MCP Server, you must first obtain a Linear API key and configure the server settings in the Claude Desktop application. Follow the installation steps provided in the documentation.
- Create and update Linear issues programmatically. - Search for issues with flexible filtering options. - Get issues assigned to specific users. - Add comments to issues directly through commands.
- Automating issue creation and updates based on user queries.
- Efficiently managing and retrieving team-specific issues.
- Enhancing interaction with Linear's issue tracking through conversational interfaces.
Add to your AI client
Use these steps to connect Linear MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"linear-mcp-server-iwark": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-linear-mcp-server-iwark"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"linear-mcp-server-iwark": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-linear-mcp-server-iwark"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"linear-mcp-server-iwark": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-linear-mcp-server-iwark"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"linear-mcp-server-iwark": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-linear-mcp-server-iwark"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"linear-mcp-server-iwark": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-linear-mcp-server-iwark"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"linear-mcp-server-iwark": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-linear-mcp-server-iwark"
]
}
}
}FAQ
How do I get a Linear API key?
You can create or retrieve your Linear API key from your Linear team settings at https://linear.app/YOUR-TEAM/settings/api.
Is there a guide for installation?
Yes! Detailed installation and usage instructions are included in the repository's README file.
Can I modify the server?
Yes, the Linear MCP Server is licensed under the MIT License, allowing you to use, modify, and distribute the software.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":191,"uuid":"9d07868f-7f31-463c-a5d6-3db96e6ca3eb","name":"linear-mcp-server","title":"Linear MCP Server","description":null,"avatar_url":"https://avatars.githubusercontent.com/u/3723159?v=4","created_at":"$D2024-12-13T09:12:30.709Z","updated_at":"$D2024-12-13T12:28:10.966Z","status":"created","author_name":"Iwark","author_avatar_url":"https://avatars.githubusercontent.com/u/3723159?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/Iwark/linear-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]