How to connect Linear MCP with ChatGPT

Connect ChatGPT 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

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 find issues, create issues, update your projects, post comments, and list planning objects through natural language commands without ever putting your account credentials at risk.

Also integrate Linear MCP 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,500+ 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

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

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

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. ChatGPT 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