MCP.so
Sign In

Linear MCP Server

@magarcia

Repository

About Linear MCP Server

A Model Context Protocol (MCP) server for the Linear API

#typescript#mcp#linear#mcp-server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-linearapp": {
      "command": "npx",
      "args": [
        "@smithery/cli",
        "install",
        "mcp-server-linearapp",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Linear MCP Server?

A Model Context Protocol server for the Linear API that integrates with Linear’s issue tracking system, enabling LLMs to interact with Linear issues, teams, projects, and more.

How to use Linear MCP Server?

Install automatically via Smithery (npx @smithery/cli install mcp-server-linearapp --client claude) or manually by adding a configuration entry to Claude Desktop’s config file with a Linear personal API key set as the LINEAR_API_KEY environment variable.

Key features of Linear MCP Server

  • 24 tools for reading and writing Linear data
  • Tools for issues, teams, projects, labels, attachments, and milestones
  • Resources to view details of issues, teams, projects, users, and organization
  • Supports creating, updating, searching, and commenting on issues
  • Flexible filtering by status, priority, assignee, labels, and team
  • Link issues and manage issue relationships
  • Create and manage milestones with target dates

Use cases of Linear MCP Server

  • Create, update, comment on, and search Linear issues via natural language
  • View a user’s assigned issues, teams, and projects
  • Manage teams, projects, milestones, and labels without leaving the chat

FAQ from Linear MCP Server

What does the server require to run?

A Linear personal API key (obtainable from Linear settings) and Node.js (via npx). The key must be set as the environment variable LINEAR_API_KEY.

How do I get a Linear API key?

Go to https://linear.app/settings/account/security to create a personal API key.

Can I filter issues by status, priority, or assignee?

Yes. Tools like linear_search_issues and linear_get_team_issues accept optional filters for status, priority, assignee, labels, and more.

Does the server support creating and updating labels?

Yes. Tools linear_create_label and linear_update_label let you add and modify labels with name, color, and description.

What transport does the server use?

The server communicates via MCP using standard I/O (stdio). Authentication is via a Bearer token (the personal API key).

Frequently asked questions

What does the server require to run?

A Linear personal API key (obtainable from Linear settings) and Node.js (via `npx`). The key must be set as the environment variable `LINEAR_API_KEY`.

How do I get a Linear API key?

Go to https://linear.app/settings/account/security to create a personal API key.

Can I filter issues by status, priority, or assignee?

Yes. Tools like `linear_search_issues` and `linear_get_team_issues` accept optional filters for status, priority, assignee, labels, and more.

Does the server support creating and updating labels?

Yes. Tools `linear_create_label` and `linear_update_label` let you add and modify labels with name, color, and description.

What transport does the server use?

The server communicates via MCP using standard I/O (stdio). Authentication is via a Bearer token (the personal API key).

Comments

Basic information

Category

Version Control

License

MIT

Transports

stdio

Author

magarcia

More Version Control MCP servers

MCP GitHub Project Manager

kunwarVivek

a mcp server to manage github project's functionality

91

Github

modelcontextprotocol

Model Context Protocol Servers

88.1K

Bitbucket MCP

MatanYemini

Bitbucket MCP - A Model Context Protocol (MCP) server for integrating with Bitbucket Cloud and Server APIs

149

Gerrit Review MCP Server

cayirtepeomer

This MCP server provides integration with Gerrit code review system, allowing AI assistants to review code changes and their details through a simple interface.

37

GitLab MCP Server

yoda-digital

Production-grade GitLab MCP server with 86 tools — full GitLab control from any AI agent (Claude, Cursor, Zed).

59