Linear MCP Integration Server
Overview
MCP-linear-Server is a server that provides integration capabilities with Linear through the Model Context Protocol (MCP), enabling AI models to interact with Linear for issue tracking and project management.
To use MCP-linear-Server, set up your environment with your Linear API key, install dependencies, and start the server either in development or production mode. You can also run it using Docker for easier management.
- Create, search, and manage Linear issues through a simple API. - Retrieve current sprint issues and project details. - Flexible filtering options for searching issues and teams. - Comprehensive error handling and logging capabilities.
- Automating issue creation in Linear for project management.
- Integrating Linear with AI tools for enhanced productivity.
- Managing project workflows and tracking progress in real-time.
Add to your AI client
Use these steps to connect Linear MCP Integration 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": {
"mcp-linear-server-madebynando": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-linear-server-madebynando"
]
}
}
}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": {
"mcp-linear-server-madebynando": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-linear-server-madebynando"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-linear-server-madebynando": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-linear-server-madebynando"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-linear-server-madebynando": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-linear-server-madebynando"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-linear-server-madebynando": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-linear-server-madebynando"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-linear-server-madebynando": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-linear-server-madebynando"
]
}
}
}FAQ
How do I get my Linear API key?
You can obtain your Linear API key from Linear's settings under the API section.
Can I run this server using Docker?
Yes! The server can be easily set up and run using Docker for better management.
What programming language is MCP-linear-Server built with?
MCP-linear-Server is built with TypeScript.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1931,"uuid":"a1664354-fbdc-4eda-bd36-4ed58f7133be","name":"MCP-linear-Server","title":"Linear MCP Integration Server","description":"","avatar_url":"https://avatars.githubusercontent.com/u/17220401?v=4","created_at":"2025-03-05T06:13:37.666Z","updated_at":"2025-03-12T10:21:43.111Z","status":"created","author_name":"MadeByNando","author_avatar_url":"https://avatars.githubusercontent.com/u/17220401?v=4","tags":"mcp,linear,integration,server,project-management","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/MadeByNando/MCP-linear-Server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-02-28 11:35:59\"}","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"}]]}]