Linear MCP server (official)
Linear's official remote server for finding, creating and updating issues, projects, comments and documents. Authorize through OAuth; a read-only endpoint is also available.
Remote (HTTP)OAuth
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 --transport http linear-official https://mcp.linear.app/mcp
Cursor
Merge into ~/.cursor/mcp.json
{
"mcpServers": {
"linear-official": {
"url": "https://mcp.linear.app/mcp"
}
}
}
Codex
Run in your terminal.
codex mcp add linear-official --url https://mcp.linear.app/mcp
codex mcp login linear-official
Gemini CLI
Merge into ~/.gemini/settings.json
{
"mcpServers": {
"linear-official": {
"httpUrl": "https://mcp.linear.app/mcp"
}
}
}
OpenCode
Merge into ~/.config/opencode/opencode.jsonc
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"linear-official": {
"type": "remote",
"url": "https://mcp.linear.app/mcp",
"enabled": true
}
}
}
VS Code
Merge into .vscode/mcp.json
{
"servers": {
"linear-official": {
"type": "http",
"url": "https://mcp.linear.app/mcp"
}
}
}
Using more than one server?Add to a config with other servers
Step-by-step setup guides: Claude Code and Codex CLI, Cursor and VS Code. In Claude Desktop, add the URL as a custom connector. This is a remote server with OAuth sign-in; see remote vs local servers and authentication and security basics.
Overview
Linear hosts its own MCP server and documents it at linear.app/docs/mcp. It is the replacement that the deprecated community server, still listed here as linear, points its users to. The server follows the authenticated remote MCP specification and uses Streamable HTTP at https://mcp.linear.app/mcp.
The tools cover everyday work in Linear. list_issues and get_issue find and read issues, and save_issue creates or updates one, including its status, assignee and labels. list_projects, list_teams and related tools give the agent the structure of your workspace, and save_comment adds comments. Linear's documentation includes example prompts for planning a roadmap from a document, triaging bugs and writing updates.
Setup uses OAuth 2.1 with dynamic client registration. Add the URL, then approve access in the browser. In Claude Code use /mcp; in Codex, run codex mcp login linear-official after adding the server. Linear also accepts a bearer token or Linear API key, and supports enterprise-managed authentication. To keep an agent from changing anything, connect to https://mcp.linear.app/mcp/readonly, which only ever exposes read tools, or request only the read OAuth scope. For clients without remote support, Linear documents running it through npx -y mcp-remote.
Example tools
list_issuesget_issuesave_issuelist_projectssave_commentlist_teams
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.