Overview
Linear MCP Server is a custom implementation of a Model Context Protocol (MCP) server that allows AI agents to interact with Linear's API for managing issues, projects, and teams programmatically.
To use the Linear MCP Server, you need to obtain a Linear API key and run the server with your API key using Node.js. You can also set it in your environment for easier access.
- Issue Management: Create, list, and update issues with customizable properties. - Team Management: List all teams and access their details. - Project Management: List projects and view their details with optional filtering.
- Automating issue creation and updates in Linear.
- Managing team assignments and project statuses programmatically.
- Integrating Linear with AI tools for enhanced project management.
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-tiovikram": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-linear-mcp-tiovikram"
]
}
}
}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-tiovikram": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-linear-mcp-tiovikram"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"linear-mcp-tiovikram": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-linear-mcp-tiovikram"
]
}
}
}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-tiovikram": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-linear-mcp-tiovikram"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"linear-mcp-tiovikram": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-linear-mcp-tiovikram"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"linear-mcp-tiovikram": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-linear-mcp-tiovikram"
]
}
}
}FAQ
Can I use Linear MCP Server without a Linear account?
No, you need a Linear account with API access to use this server.
Is there a cost associated with using Linear MCP Server?
The server is free to use, but you must have a Linear account with the necessary permissions.
What programming language is Linear MCP Server built with?
Linear MCP Server is built with TypeScript.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1724,"uuid":"3f882223-e887-4890-bef9-489a269acd86","name":"linear-mcp","title":"Linear MCP Server","description":"MCP server for Linear (","avatar_url":"https://avatars.githubusercontent.com/u/45928972?v=4","created_at":"2025-03-05T05:02:54.903+00:00","updated_at":"2025-03-12T10:20:30.741+00:00","status":"created","author_name":"tiovikram","author_avatar_url":"https://avatars.githubusercontent.com/u/45928972?v=4","tags":"linear-mcp,mcp-server,api-integration","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/tiovikram/linear-mcp","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"\",\"language\":\"JavaScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-04 17:00:23\"}","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"}]]}]