How to connect Linear with ChatGPT

Connect ChatGPT to Linear MCP. Create a new bug for team mobile, add a comment to issue lin-123, and more using natural language, with authentication handled for you.

Linear logoLinear
Oauth2Api Key

Linear is a modern issue tracking and project planning tool for fast-moving teams. It helps streamline workflows, organize projects, and boost productivity.

47 Tools12 Triggers

How to connect Linear MCP with ChatGPT

ChatGPT can take action across your apps and files, stay with a project for hours, and turn a goal into finished materials like sheets, slides, and docs, not just answers.

In this guide, I will explain the easiest and most secure way to connect your Linear account to ChatGPT via Composio Connect, so it can create and update issues, manage projects and milestones, post comments, track cycles, and search issues across teams through natural language commands without ever putting your account credentials at risk.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Linear with

Why use Composio over default connectors?

  • Apps with read and write access. Default connectors mostly can read your data. Composio's Linear integration lets ChatGPT take actions like creating drafts, sending updates, labeling records, and more.
  • 1,700+ SaaS toolkits out of the box. Composio gives you instant access to a vast catalog of pre-built connectors, from Gmail and Slack to Notion, Linear, and Salesforce.
  • One MCP server for every app. Connect any of your applications on demand through a single endpoint, rather than juggling a separate server for each app.
  • Smart, context-aware tool loading. Unlike traditional MCP servers that dump every available tool into the LLM context window, Composio searches for and loads only the tools relevant to the task at hand.
  • Cross-app automation. Chain actions across multiple apps in a single run - fetch a thread, summarize it in Notion, and post highlights to Slack without leaving the conversation.

Prerequisites

Note: Composio connects through OAuth. You will be asked to sign in and approve specific permissions. Review the permission screen carefully if you are using a work account.

Step-by-step: Connect Linear to ChatGPT

1. Install the Composio plugin

Click the button. ChatGPT opens the Composio plugin page. Click Install plugin.

Install in ChatGPT

Composio plugin page in ChatGPT with the Install plugin button

You can also find it inside ChatGPT: go to Settings, open Plugins, search the marketplace for Composio, and click Install plugin.

2. Authenticate

After you install, ChatGPT asks you to authenticate with Composio. Log in and click Allow access to authorize ChatGPT to use your Composio account.

Composio login and Allow access screen for ChatGPT

3. Start using Composio

That is it. Composio tools are now available in ChatGPT. Type @Composio followed by your request, for example @Composio find unread Linear messages and summarize them, and it will run the actions you authorize. On first use it asks you to authorize Linear.

Option 2: Add Composio as an MCP server

If you cannot use the plugin marketplace, add Composio as a custom MCP server instead.

1. Open the MCP settings

In ChatGPT, go to Settings and open the Plugins section. Inside the Plugins page, click the MCP tab.

ChatGPT settings showing the Plugins page with the MCP tab selected

2. Add the server

Click Add server. In the Name field enter Composio, for Type select Streamable HTTP, and in the URL field paste the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
ChatGPT Add server dialog with the name Composio, type Streamable HTTP, and the Composio MCP URL

Then click Save. The Composio server now appears in your MCP plugins list.

ChatGPT Plugins page showing the Composio MCP server added to the list

3. Authenticate

Click Authenticate on the Composio entry, log in via Composio, and click Allow access. Composio tools are then available in ChatGPT the same way as with the plugin.

What you can do after connecting Linear

  • Create a new bug for team Mobile
  • Add a comment to issue LIN-123
  • List all cycles for the Design team
  • Download the latest attachment from issue LIN-456

Security + privacy notes (important)

  • Use least-privilege access: Only grant permissions you actually need.
  • Review OAuth permissions before approving: Make sure requested scopes match what you expect Composio and ChatGPT to do.
  • Keep write actions human-reviewed: For actions like sending messages, creating labels, or editing drafts, keep manual confirmation enabled.
  • Be careful with sensitive data: Avoid using this setup with highly sensitive information unless allowed by your personal, company, or client policies.
TOOLS & TRIGGERS

Supported Tools and Triggers

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

Archive issue

Archives an existing Linear issue by its UUID or shorthand identifier, removing it from active views while preserving its data for future reference.

Archive Project

Archives an existing Linear project by its UUID, removing it from active views.

Archive Project Update

Archives a project update in Linear, hiding it from the default view while preserving its data.

Create attachment

Creates a new attachment and associates it with a specific, existing Linear issue.

Add reaction to comment

Tool to add a reaction to an existing Linear comment.

Create a comment

Creates a new comment on a specified Linear issue.

Create linear issue

Creates an issue in a specified Linear team with a title and optional project, description, assignee, state, priority, cycle, due date, and other properties.

Create issue relation

Create a relationship between two Linear issues using the issueRelationCreate mutation.

Create a label

Creates a label for a specified Linear team, or returns an existing exact-name match found in the team's initial label results.

Create Project

Creates a new Linear project with specified name and team associations.

Create Project Milestone

Tool to create a project milestone in Linear with a name and optional target date and sort order.

Create Project Update

Tool to create a project status update post for a Linear project.

Create Team

Creates a new team in Linear with the specified name and key.

Delete issue

Archives an existing Linear issue by its ID, which is Linear's standard way of deleting issues; the operation is idempotent.

Download issue files

Downloads a Linear Attachment record or a private upload embedded in issue/comment Markdown; `file_name` must include the correct extension.

Get a comment

Retrieves a single Linear comment by its unique ID.

Get current user

Gets the currently authenticated Linear user's ID, name, email, and other profile information.

Get cycles by team ID

Lists cycles for a specified Linear team ID, including progress, creation and end times, and history.

Get create issue default params

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

Get Linear issue

Retrieves a Linear issue by UUID or shorthand identifier, including its details, parent, cycle, attachments, comments and subscribers.

Get Linear project

Retrieves a single Linear project by its unique identifier.

Get Project Update

Retrieves a specific project update by its unique identifier.

List comments

Lists comments from Linear workspace accessible to the authenticated user.

List issue drafts

Lists the connected user's issue drafts for review or editing.

List issues by team ID

Tool to list all issues for a specific Linear team, scoped by team ID.

Get all cycles

Lists cycles across the Linear account without filters, including team IDs and scheduled end times.

List Linear issues

Lists non-archived Linear issues with optional project and assignee filters, returning a paginated issues array and page_info.

Get labels

Retrieves paginated Linear issue labels for a specified team or across the workspace.

List linear projects

Retrieves all projects from the Linear account.

List Linear states

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

Get teams

Lists visible Linear teams with their members and project IDs, with pagination for teams but not nested members or projects.

List Linear users

Lists workspace users with IDs, names, emails, and active status.

List project updates

Retrieves all project updates from the Linear workspace.

Remove label from Linear issue

Removes a specified label from a Linear issue using the issue and label IDs, and returns the updated issue and labels.

Remove reaction from comment

Tool to remove a reaction on a comment.

Resolve comment

Marks a Linear comment as resolved.

Run Query or Mutation

Execute a Linear GraphQL query or mutation to retrieve or change accessible data.

Search Linear issues

Searches Linear issues by full-text query, with pagination and an option to include archived issues.

Unarchive Project Update

Unarchive a previously archived project update in Linear.

Unresolve a comment

Unresolves a previously resolved Linear comment, marking it as requiring attention again.

Update issue

Updates an existing Linear issue by ID, requiring at least one field to modify; supplied fields overwrite existing values and labels replace the label set.

Update a comment

Tool to update an existing Linear comment's body text.

Update Project

Tool to update an existing Linear project.

Update Project Update

Tool to update an existing Linear project update post.

Update Team

Updates an existing Linear team's settings, including its name, key, cycle settings, and workflow state configuration.

Validate credential

Validates the Linear API credentials by checking if the authentication token can successfully query the current user.

Who Am I

Return the identity (name, email) of the connected Linear account.

FAQ

Frequently asked questions

Start with Linear.It takes 30 seconds.

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

Start building