How to connect Linear MCP to Claude

Connect Claude Web, Desktop and Cowork to Linear MCP. List all open issues assigned to me, create a new issue from template, and more using natural language, with authentication handled for you.

Linear MCP logoLinear MCP
Dcr Oauth

Linear MCP is Linear's interface for managing issues, projects, comments, and planning objects within a workspace. It centralizes planning data and simplifies tracking, prioritization, and collaboration across teams.

67 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Linear account to Claude via Composio Connect, enabling it to list all open issues assigned to me, create a new issue from template, add comment to issue by ID, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Linear MCP with

Connecting Linear to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Linear account

Back in Claude, ask it to connect to Linear or give it any Linear-related task.

For example, ask Claude to:

  • "List all open issues assigned to me"
  • "Create a new issue from template"
  • "Add comment to issue by ID"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Linear account is ready to use.

What is the Linear Claude Connector, and what's possible with it?

The Linear MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Linear account. It provides structured and secure access so your agent can perform Linear operations on your behalf.

Troubleshooting

1. Why does Claude not use the Composio connector for Linear?

The connector can show as connected, but Claude must use it in each Linear conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Linear again.

2. Why does Claude show an MCP server error before Linear connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Linear.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Linear.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Linear authorization link not work?

The Composio connector is one server. Your Linear account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Linear connection.
  • Composio creates a fresh Linear authorization link.
  • Open that link in your browser and finish the Linear sign-in.

4. Why do Linear actions fail after they worked before?

The Linear connection can expire or lose permission.

  • Ask Claude to inspect the Linear connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Linear account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Linear.
  • If the action still fails with a permission error, check that the connected account has that permission in Linear itself.

5. How do I switch to a different Linear account?

Claude can manage the Linear connection for you.

  • Ask Claude to disconnect or delete the current Linear account.
  • Ask Claude to connect Linear again.
  • Open the new Composio authorization link for Linear.
  • Sign in with the other Linear account in the browser.
  • After the account connects, ask Claude to retry the Linear task.

6. Why is my Linear connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Linear connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Linear tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Linear.
TOOLS

Supported Tools

Every Linear MCP action and event your agent gets out of the box.

Create attachment

Deprecated fallback for tiny files only.

Create attachment from upload

Link an already-uploaded Linear assetUrl to an existing issue as an attachment.

Create initiative label

Create a new Linear initiative label

Create issue label

Create a new Linear issue label

Delete attachment

Delete an attachment by ID

Delete comment

Delete a Linear comment.

Delete customer

Delete a customer in Linear

Delete customer need

Archive a customer need in Linear

Delete diff comment

Delete a comment or persisted draft from a Linear diff

Delete status update

Delete (archive) a project or initiative status update.

Extract images

Extract and fetch images from markdown content.

Get agent skill

Retrieve a Linear Agent skill by ID, including its full markdown instructions.

Get attachment

Retrieve an attachment's content by ID.

Get diff

Exact lookup for a Linear diff.

Get diff threads

Exact lookup for diff threads and the authenticated user's drafts.

Get document

Retrieve a Linear document by ID or slug

Get initiative

Retrieve detailed information about a specific initiative in Linear

Get issue

Retrieve detailed information about an issue by ID, including attachments, git branch name, and active Triage Intelligence suggestions when the issue is in triage

Get issue status

Retrieve detailed information about an issue status in Linear by name or ID

Get milestone

Retrieve details of a specific milestone by ID or name

Get project

Retrieve details of a specific project in Linear

Get release

Retrieve details of a release by ID or slug.

Get release note

Retrieve release notes by ID or slug, including markdown content.

Get status updates

List or get project/initiative status updates.

Get team

Retrieve details of a specific Linear team

Get template

Retrieve a Linear template by ID or name: the content it pre-fills, the ids it applies, its sub-issues, and its form fields.

Get user

Retrieve details of a specific Linear user

Get workspace

Retrieve the connected Linear workspace

List agent skills

List Linear Agent skills available to the authenticated user.

List comments

List comments on a Linear issue, project, initiative, document, project milestone, or project/initiative status update.

List customers

List customers in the user's Linear workspace

List cycles

Retrieve cycles for a specific Linear team

List diffs

List Linear diff pull requests visible to the authenticated user

List documents

List documents in the user's Linear workspace

List initiative labels

List available initiative labels in the Linear workspace

List initiatives

List initiatives in the user's Linear workspace

List issue labels

List available issue labels in a Linear workspace or team

List issues

List issues in the user's Linear workspace, including active Triage Intelligence suggestions for issues in triage.

List issue statuses

List available issue statuses in a Linear team

List milestones

List all milestones in a Linear project

List project labels

List available project labels in the Linear workspace

List projects

List projects in the user's Linear workspace

List release notes

List release notes in the workspace, optionally filtered by pipeline or covered release.

List release pipelines

List release pipelines in the workspace.

List releases

List releases in the workspace, with optional filtering by pipeline, stage, version, and text.

List teams

List teams in the user's Linear workspace

List templates

List the Linear issue, project, and document templates available to the authenticated user.

List users

Retrieve users in the Linear workspace

Merge diff

Merge a Linear diff or add it to the repository's merge queue

Prepare attachment upload

Prepare a direct Linear file upload for an existing issue.

Resolve diff thread

Resolve or reopen a top-level comment thread on a Linear diff

Save comment

Create or update a comment on a Linear issue, project, initiative, document, project milestone, or project/initiative status update.

Save customer

Create or update a Linear customer.

Save customer need

Create or update a customer need (request) in Linear.

Save diff comment

Create, reply to, or edit a comment or persisted draft on a Linear diff.

Save document

Create or update a Linear document.

Save initiative

Create or update a Linear initiative.

Save issue

Create or update a Linear issue.

Save milestone

Create or update a milestone in a Linear project.

Save project

Create or update a Linear project.

Save release

Create or update a release.

Save release note

Create or update release notes.

Save status update

Create or update a project/initiative status update.

Search documentation

Search Linear's documentation to learn about features and usage

Share issue

Share an issue with a workspace user who cannot otherwise access it.

Submit diff review

Approve a Linear diff, request changes, or submit a review comment

Unshare issue

Remove a workspace user's shared access to an issue.

FAQ

Frequently asked questions

With a standalone Linear MCP server, the agents and LLMs can only access a fixed set of Linear tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Linear and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Linear tools.

Yes, absolutely. You can configure which Linear scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Linear data and credentials are handled as safely as possible.

Start with Linear MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Linear MCP tool your agent needs.Free to start.

Start building