Linear Integration

The Linear integration provides access to manage Linear issues, projects, and cycles through the Integrate MCP server.

Installation

The Linear integration is included with the SDK:

import { linearIntegration } from "integrate-sdk/server";

Setup

1. Create a Linear OAuth App

1. Go to Linear Settings
2. Create a new OAuth application
3. Configure your redirect URI
4. Note your Client ID and Client Secret

2. Configure the Integration on Your Server

Add the Linear integration to your server configuration. The integration automatically reads LINEAR_CLIENT_ID and LINEAR_CLIENT_SECRET from your environment variables:

import { createMCPServer, linearIntegration } from "integrate-sdk/server";

export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    linearIntegration({
    }),
  ],
});

You can override the environment variables by passing explicit values:

linearIntegration({
  clientId: process.env.CUSTOM_LINEAR_ID,
  clientSecret: process.env.CUSTOM_LINEAR_SECRET,
});

3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

import { client } from "integrate-sdk";

await client.authorize("linear");
const result = await client.linear.createIssue({
  teamId: "value",
});

console.log(result);

If you're using a custom client, add the integration to the integrations array:

import { createMCPClient, linearIntegration } from "integrate-sdk";

const customClient = createMCPClient({
  integrations: [linearIntegration()],
});

Configuration Options

Tools

linear_create_issue

Create a new issue in Linear

linear_list_issues

List issues in Linear

linear_get_issue

Get a specific issue by ID or identifier

linear_update_issue

Update an existing issue

linear_archive_issue

Archive an issue

linear_delete_issue

Delete an issue permanently

linear_search_issues

Search for issues

linear_add_comment

Add a comment to an issue

linear_list_users

List users in the workspace

linear_get_user

Get a specific user by ID

linear_list_teams

List teams in Linear

linear_list_workflow_states

List workflow states

linear_create_workflow_state

Create a new workflow state

linear_list_projects

List projects in Linear

linear_get_project

Get a specific project by ID

linear_create_project

Create a new project

linear_update_project

Update an existing project

linear_list_cycles

List cycles (sprints)

linear_get_cycle

Get a specific cycle by ID

linear_create_cycle

Create a new cycle (sprint)

linear_update_cycle

Update an existing cycle

linear_list_labels

List labels in Linear

linear_create_issue_relation

Create a relation between two issues

linear_delete_issue_relation

Delete an issue relation

linear_list_documents

List documents

linear_get_document

Get a specific document by ID

linear_create_document

Create a new document

linear_update_document

Update an existing document

linear_list_initiatives

List initiatives

linear_get_initiative

Get a specific initiative by ID

linear_create_initiative

Create a new initiative

linear_create_attachment

Create an attachment (link) on an issue

linear_create_project_update

Create a status update for a project

Notes

• Category: Engineering
• Authentication mode: OAuth