Linear MCP community server (deprecated)
Deprecated community Linear integration for issues and projects. Upstream recommends the official remote Linear server.
Local (stdio)CredentialDeprecated upstream
Deprecated upstream. This server is no longer maintained by its authors and receives no fixes or security updates. The configuration below is kept for existing users; review the upstream notice before installing it. For new setups, see the maintained Linear listing.
Set up Linear
Configuration examples, not tested connections. Replace placeholders and review the upstream documentation before use.
Claude Code
Run in your terminal.
claude mcp add linear --env LINEAR_API_KEY="$LINEAR_API_KEY" -- npx -y linear-mcp-server
Cursor
Merge into ~/.cursor/mcp.json
{
"mcpServers": {
"linear": {
"command": "npx",
"args": [
"-y",
"linear-mcp-server"
],
"env": {
"LINEAR_API_KEY": "REPLACE_WITH_LINEAR_API_KEY"
}
}
}
}
Codex
Run in your terminal.
codex mcp add linear --env LINEAR_API_KEY="$LINEAR_API_KEY" -- npx -y linear-mcp-server
Gemini CLI
Merge into ~/.gemini/settings.json
{
"mcpServers": {
"linear": {
"command": "npx",
"args": [
"-y",
"linear-mcp-server"
],
"env": {
"LINEAR_API_KEY": "REPLACE_WITH_LINEAR_API_KEY"
}
}
}
}
OpenCode
Merge into ~/.config/opencode/opencode.jsonc
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"linear": {
"type": "local",
"command": [
"npx",
"-y",
"linear-mcp-server"
],
"enabled": true,
"environment": {
"LINEAR_API_KEY": "REPLACE_WITH_LINEAR_API_KEY"
}
}
}
}
VS Code
Merge into .vscode/mcp.json
{
"servers": {
"linear": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"linear-mcp-server"
],
"env": {
"LINEAR_API_KEY": "${input:LINEAR_API_KEY}"
}
}
},
"inputs": [
{
"id": "LINEAR_API_KEY",
"type": "promptString",
"description": "LINEAR_API_KEY",
"password": true
}
]
}
Step-by-step setup guides: Claude Code and Codex CLI, Cursor and VS Code. In Claude Desktop, the Cursor JSON goes in claude_desktop_config.json. This is a local server that runs on your machine; see remote vs local servers and authentication and security basics.
Overview
linear-mcp-server is a community-built Model Context Protocol server for Linear, the issue-tracking tool, published on npm as linear-mcp-server. Its README now opens with an important note: the server is deprecated and no longer maintained, and the author recommends Linear's official remote MCP server instead. Linear announced that server in its changelog on 1 May 2025.
The server talked to Linear's GraphQL API. Its tools were linear_create_issue, linear_update_issue and linear_search_issues, which filters by text, team, status, assignee, labels and priority, plus linear_get_user_issues and linear_add_comment. It also published issues, team issue lists, a user's assigned issues and organization details as resources an agent could read. It suited workflows like turning a bug report from a conversation into a ticket, triaging a backlog, or summarising what is assigned to you.
Setup caveats: it authenticates with a Linear API key in the LINEAR_API_KEY environment variable. That key acts as your user, with your workspace permissions, so treat it like a password; the snippets below read it from your environment or use a placeholder. Because the package will not be updated as Linear's API changes, new setups should follow Linear's own MCP documentation and use the official server. We keep this page so existing users can find their configuration and see the recommended path.
Example tools
linear_create_issuelinear_update_issuelinear_search_issues
Tool names are upstream examples. The server's live tool list can differ.
Related Productivity servers
Sources
This page was written from the upstream documentation below and last reviewed on 11 October 2026. Listing is not a security or compatibility endorsement. Report a correction through the contact page.