How to connect Claude to Linear

Yes. Linear is a built-in Claude connector. Add it from Customize > Connectors and Claude can search, create and update your issues.

Picks: 3; ranked

To connect Claude to Linear, open Customize > Connectors in Claude, click the + next to Connectors, pick Linear and choose Connect. Anthropic says directory connectors are open to all users, including Free. Claude can then search, create and update your Linear issues, projects and comments. Know this first: the default connection can change your workspace, so check the read-only options in the setup box if you only want Claude to look.

Good for

Engineers who want Claude to file and update issues without leaving the chat
Product managers who triage backlogs and write issue summaries
Team and Enterprise admins who roll Linear out to a whole org
Claude Code users who want tickets next to their code

Install Claude

Claude Code

Copy this prompt.

Add the Claude MCP server to Claude Code. Run this command:

claude mcp add --transport http linear-server https://mcp.linear.app/mcp

Then check that it loaded and tell me if I need to sign in or restart.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires A Linear account.

Read-only mode: Want it to only read? Use https://mcp.linear.app/mcp/readonly in place of https://mcp.linear.app/mcp in the command.

Run /mcp in a session and pick Linear to sign in. If you already added Linear on claude.ai and are logged in with that account, it shows up in Claude Code as a claude.ai connector.

From the vendor's docs. Source.

Connect Claude to Linear and run your first task

Claude

1
Open the connectors page
In Claude, go to Customize > Connectors. You can also open claude.ai/customize/connectors directly.
2
Add Linear
Click the + next to Connectors to open the directory. Click Linear, review what it asks for, then click Connect.
Uses Linear
3
Sign in to Linear
Follow the sign-in prompts and approve access. If it fails, try again. Linear warns that the connection can need more than one attempt.
Tip: On Team or Enterprise, an Owner has to add Linear to the organization first. Use the setup box above.
4
Turn Linear on in a chat
In a chat, click the + button (lower left), hover Connectors and switch Linear on for this conversation.
5
Create an issue
Ask Claude to file something.
Prompt
```
Create a new issue for the login bug.
```
Uses Linear
6
Find your open work
Ask for a read-only summary.
Prompt
```
List the open issues assigned to me and group them by project.
```
Uses Linear
7
Comment on an issue
Check the result in Linear afterwards.
Prompt
```
Add a comment to the login bug issue saying we can reproduce it on Safari.
```
Uses Linear

Permissions

Medium risk

Claude can change or create things in your Linear workspace, not just read them. Use Linear's read-only address, or have an Owner set write tools to Needs approval, if you want Claude to only look.

What it can do

Read your data
Create and change things
Delete things
Read-only modeHow to turn it on

Watch out for

It can create and change issues, not just read
The default connection can write to your workspace. Use the read-only address, or have an Owner set write tools to Needs approval. linear.app
Org rules narrow access but do not widen it
Blocked or approval-only tools apply to everyone in the org. People still need the matching permission in Linear. support.claude.com
Connect only trusted connectors
Claude's listing warns to use connectors only from developers you trust. Linear is the publisher of this one. claude.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details

Turning on read-only	Connect to https://mcp.linear.app/mcp/readonly, or request only the read OAuth scope. On Team and Enterprise, Owners can set Linear tools to Needs approval or Blocked.
Talks to	mcp.linear.app
Sign-in and keys	You sign in with your Linear account. Claude holds the connection, and each person signs in separately.
Scopes	read (read-only address)

Where it works

Where	Status	Note
claude.ai	Native connector	Linear's own connector in the Claude directory. Add it under Customize > Connectors and sign in with Linear.
Claude Desktop	Native connector	Same directory connector as claude.ai. Anthropic says directory connectors work on web, desktop and mobile.
Claude Code	Official server	Add Linear's hosted server with one command, or install the official Linear plugin. A claude.ai connector also carries over.
Claude mobile	Native connector	Connectors you add on web or desktop are available in the Claude mobile apps.
ChatGPT	Official app	Linear connector for deep research on Plus and Pro (not EEA, Switzerland or UK), Team, Enterprise and Edu.
Gemini	Unknown	Gemini Enterprise has a Linear data store in preview. Nothing documented for the consumer Gemini app.
Microsoft Copilot	Official app	Microsoft 365 Copilot has a Linear connector. An admin enables it and users need a Copilot licence.

ChatGPT

ChatGPT reaches Linear through a deep research connector. Connect it in connector settings, then add Linear as a source.

Plan: ChatGPT Plus or Pro (not in the EEA, Switzerland or the UK), Team, Enterprise or Edu for the deep research connector.

What it can do

Pull Linear issues and projects into a deep research report

Limits

Linear lists the connector for deep research, with your own Linear permissions applied.

Plugs to turn on

Linear: The /mcp/linear page covers the ChatGPT setup in full.

Claude

Linear is a first-party connector in Claude's directory, published by Linear and marked Anthropic verified. Each person signs in with their own Linear account.

Plan: Any Claude plan. Anthropic says directory connectors are available for all users.

What it can do

Search and read issues, projects, cycles and comments
Create and update issues and projects
Add comments to issues
Use the same connection in Claude Code after you add it on claude.ai

Limits

On Team and Enterprise, an Owner must add Linear for the org first, then each person signs in.
On Team and Enterprise, connectors work only in private projects, and chats with synced content cannot be shared.

Plugs to turn on

Linear: Linear's own server is what the directory connector and the official Claude Code plugin use.

Microsoft Copilot

Microsoft publishes its own Linear connector for Microsoft 365 Copilot. GitHub Copilot cloud agent can also take Linear issues.

Plan: Microsoft 365 Copilot license. An admin must allow the connector first.

What it can do

Search and work with Linear issues from Microsoft 365 Copilot Chat
Assign a Linear issue to GitHub Copilot and get a draft pull request

Limits

Write and delete actions default to Needs approval, and the Researcher agent stays read-only.
The GitHub Copilot route needs a GitHub org owner and a Linear workspace admin to install it.

Plugs to turn on

Linear: Linear's hosted server also works in GitHub Copilot clients.

Gemini

Google built a Linear data store for Gemini Enterprise. Individuals can use Gemini CLI with Linear's server.

Plan: Gemini Enterprise, or Gemini CLI with the hosted server. No consumer Gemini app connector is documented.

What it can do

Search Linear and save comments, issues and projects from Gemini Enterprise

Limits

The Gemini Enterprise connector is in public preview.
An admin must create a Linear OAuth app first.

Plugs to turn on

Linear: Works in Gemini CLI as well; see the /mcp/linear page.

Top picks

Ranked by official status first, then stars and recent commits. The official server is first because it is the one Claude's own connector uses.

Verdict

Use Linear's own connector from the Claude directory. It needs no URL, no key and works on every plan. Its main limit is that it can create and change issues; in Claude Code you can switch to Linear's read-only address, and on Team and Enterprise an Owner can block write tools.

Our pick: Linear

Use Linear's own connector from the Claude directory. It needs no URL, no key and works on every plan.

Its main limit is that it can create and change issues; in Claude Code you can switch to Linear's read-only address, and on Team and Enterprise an Owner can block write tools.

Best for

Anyone who wants Claude to search or file Linear issues
Team and Enterprise orgs that want admin control over which tools Claude can use
Claude Code users who already added Linear on claude.ai

Skip it if

You need read-only access with no extra setup
You run Claude Code with many tools and want the smallest token cost, where streamlinear may fit better

Questions

How do I connect Linear to Claude?

Open Customize > Connectors, click the + next to Connectors, choose Linear and click Connect. Then sign in with your Linear account. The setup box above has the full steps.

Is there an official Linear connector for Claude?

Yes. Linear publishes it in Claude's connector directory, and it carries the Anthropic verified badge.

Does the Linear connector work on the Free plan?

Yes. Anthropic says directory connectors are available for all users, Free included. Linear's own docs still list narrower plans; follow Anthropic, since it runs the directory.

Is it free?

Linear lists no separate price for the connector. You need a Linear account and a Claude account, and normal plan rules for both apply.

Can Claude create or change Linear issues?

Yes. It can create and update issues, projects and comments. See the read-only question below if you do not want that.

Can I make Claude read-only in Linear?

Yes in Claude Code: use Linear's read-only address in the command. On Team and Enterprise, an Owner can set Linear tools to Needs approval or Blocked for everyone. Neither Linear nor Anthropic documents a read-only switch for the claude.ai directory connector.

Does the connector I added on claude.ai show up in Claude Code?

Yes, when you are logged in to Claude Code with your claude.ai account. It appears as a claude.ai connector. If you also added Linear by hand, you may see two entries.

How does an admin turn it on for the whole team?

An Owner opens Organization settings > Connectors, clicks Browse connectors, picks Linear and clicks Add to your team. Each person still signs in with their own Linear account.

Why does Claude say Linear is not connected when it is?

This is a known bug in Claude Code. Calling a Linear tool usually works anyway. If not, disconnect and reconnect the connector.

Why does sign-in fail after I reconnect?

Users have reported authorization failing after removing and re-adding the connector. Try again, or add Linear directly in Claude Code and turn off the claude.ai connector.

Information

updated Nov 1, 2026

Made by: Anthropic
Connector directory: claude.ai/directory

In the Claude directory

Sources

Docs, issue trackers and discussions this page is built from.

Show all 18

Use connectors to extend Claude's capabilities · support.claude.com
Use the connectors directory to extend Claude's capabilities · support.claude.com
MCP server - Linear Docs · linear.app
Claude integration - Linear · linear.app
claude-plugins-official: linear plugin · github.com
Connect Claude Code to tools via MCP · code.claude.com
Linear connector - Claude · claude.com
Session-start connector status falsely reports Linear as requiring auth · github.com
claude.ai Linear MCP: Authorization fails after reconnecting connector · github.com
claude.ai Linear connector still on deprecated /sse transport · github.com
linear-mcp-server README · github.com
ChatGPT integration - Linear · linear.app
Linear data store - Gemini Enterprise · docs.cloud.google.com
Microsoft connectors gallery · learn.microsoft.com
Federated connectors overview · learn.microsoft.com
Copilot cloud agent for Linear is now generally available · github.blog
tacticlaunch/mcp-linear · github.com
streamlinear README · github.com