Question 1

What is Linear MCP for Claude Opus?

Accepted Answer

Linear MCP for Claude Opus is a Model Context Protocol connector that lets Claude interact with your Linear workspace via the Linear API. It enables conversational creation, querying, and management of issues, projects, and workflows.

Question 2

How do I install and configure the connector?

Accepted Answer

Install the Linear MCP server in your MCP client environment, set your LINEAR_API_KEY, and register the server in the client config. Restart the client, authenticate if prompted, and test by asking Claude to list teams or create a test issue.

Question 3

Which Linear actions are supported?

Accepted Answer

Typical actions include creating and updating issues, assigning owners, changing statuses, adding labels and comments, linking projects, searching issues, and reading teams, projects, and workflows. Exact capabilities depend on the MCP server and your API scopes.

Question 4

Can Claude create and update Linear issues?

Accepted Answer

Yes. With appropriate API permissions, Claude can create new issues, edit titles and descriptions, change status, assign teammates, add labels, and comment, all from natural-language requests.

Question 5

Is the integration secure for enterprise use?

Accepted Answer

It communicates with Linear over HTTPS and uses your API key or OAuth for auth. Access is constrained to your key’s scopes and Linear role permissions. Store secrets securely (env vars or a secrets manager) and follow your org’s security policies.

Question 6

Does it work with multiple Claude or user sessions?

Accepted Answer

Yes. Each session can use its own API key and workspace context, so multiple teammates can work concurrently. Ensure each client is configured with the correct credentials and permissions.

Question 7

What permissions or API scopes are required?

Accepted Answer

At minimum, read access is needed to query data; write scopes are required to create or modify issues and projects. Admin actions (like managing teams) require higher privileges. Use the least-privilege principle.

Question 8

Does it work on all Linear plans?

Accepted Answer

It works on Linear plans that include API access. Some advanced features or higher rate limits may require paid tiers. Check your plan details and the Linear API limits.

Question 9

How do I troubleshoot common setup issues?

Accepted Answer

Verify the API key is valid and has the needed scopes, confirm the workspace and team IDs, and check MCP client logs for errors. Regenerate the key if revoked, and ensure your client can reach Linear’s API endpoints.

Question 10

What does it cost to use the connector?

Accepted Answer

The connector itself is typically free or open-source. Costs come from your Linear subscription and any Claude usage or hosting resources you consume.

Connect Linear to Claude Opus (Anthropic) to unlock the power of AI automation

Linear MCP tools

create-linear-attachmentCreates a new attachment and associates it with a specific, existing Linear issue.

create-linear-attachment

create-linear-commentCreates a new comment on a specified Linear issue.

create-linear-comment

create-linear-issueCreates a new issue in a specified Linear project and team, requiring a title and description, and allowing for optional properties like assignee, state, priority, cycle, and due date.

create-linear-issue

create-linear-issue-detailsFetches a Linear team's default issue estimate and state, useful for pre-filling new issue forms.

create-linear-issue-details

create-linear-labelCreates a new label in Linear for a specified team, used to categorize and organize issues.

create-linear-label

delete-linear-issueArchives an existing Linear issue by its id, which is Linear's standard way of deleting issues; the operation is idempotent.

delete-linear-issue

get-all-linear-teamsRetrieves all teams from the Linear workspace without requiring any parameters.

get-all-linear-teams

get-attachmentsDownloads a specific attachment from a Linear issue; the `file name` must include the correct file extension.

get-attachments

get-current-userGets the currently authenticated user's id, name, email, and other profile information.

get-current-user

get-cycles-by-team-idRetrieves all cycles for a specified Linear team id; cycles are time-boxed work periods (like sprints) and the team id must correspond to an existing team.

get-cycles-by-team-id

get-linear-issueRetrieves an existing Linear issue's comprehensive details, including title, description, attachments, and comments.

get-linear-issue

list-linear-cyclesRetrieves all cycles (time-boxed iterations for work) from the Linear account; no filters are applied.

list-linear-cycles

list-linear-issuesLists non-archived Linear issues; if project id is not specified, issues from all accessible projects are returned.

list-linear-issues

list-linear-labelsRetrieves all labels associated with a given team id in Linear; the team id must refer to an existing team.

list-linear-labels

list-linear-projectsRetrieves all projects from the Linear account.

list-linear-projects

list-linear-statesRetrieves all workflow states for a specified team in Linear, representing the stages an issue progresses through in that team's workflow.

list-linear-states

list-linear-teamsRetrieves all teams, including their members, and filters each team's associated projects by the provided 'project id'.

list-linear-teams

list-linear-usersLists all users in the Linear workspace with their ids, names, emails, and active status.

list-linear-users

remove-issue-labelRemoves a specified label from an existing Linear issue using their ids; successful even if the label isn't on the issue.

remove-issue-label

run-query-or-mutationWildcard action that executes any graphql query or mutation against the Linear API.

run-query-or-mutation

update-issueUpdates an existing Linear issue using its `issue id`; requires at least one other attribute for modification, and all provided entity ids (for state, assignee, labels, etc.

update-issue

comment-event-triggerTriggered when a comment is received.

comment-event-trigger

issue-created-triggerTriggered when a new issue is created.

issue-created-trigger

issue-updated-triggerTriggered when an issue is updated.

issue-updated-trigger

Linear connector for other AI models (LLMs)

ChatGPT

Grok

Gemini

Sonar

Claude Sonnet

Mistral

DeepSeek Chat

Llama

Need inspiration? What's in your stack?

Airtable

Canva

GitHub

Gmail

Google Drive

HubSpot

Notion

Salesforce

Frequently Asked Questions