How to connect Claude Code to Linear
Connect Claude Code to Linear, authorize access, and verify the connection using the official setup.
Free guide · Updated
Based on official documentation · Checked
Ask your agent
Copy the prompt and paste it into your assistant.
Quick answer
Connect Claude Code to Linear using the official Linear setup described below, authorize the account, then check access with a read-only request.
Before you start
Install Claude Code and sign in to an account with access to the intended Linear workspace or projects. Review the permissions requested during authorization; connecting a tool can expose account data or allow changes depending on the integration.
Add the connection
Add Linear’s hosted MCP server to Claude Code. This example uses Linear’s read-only endpoint.
claude mcp add --transport http linear https://mcp.linear.app/mcp/readonlyAuthorize the account
Start Claude Code, enter /mcp, select Linear and complete the OAuth sign-in for the intended workspace. The read-only endpoint exposes read tools; use the standard /mcp endpoint only when you need changes.
Practice
Check the connection
- Ask Claude to list a few issues from a project you can access; compare the titles with Linear.
Output: The result matches data visible in your Linear account.
Troubleshooting and disconnecting
If tools are missing, check the server or plugin status in Claude Code, restart the session if necessary and confirm you authorized the correct Linear account. If access is denied, check your workspace membership and permissions. To disconnect, remove or disable the server or plugin in the client and revoke its authorization in Linear when appropriate. Avoid pasting access tokens into public files.
Sources