MCP.so
Sign In

Linear MCP Server

@magarcia

Basic information

Category

Version Control

License

MIT

Transports

stdio

Author

magarcia

About Linear MCP Server

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

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"
      ]
    }
  }
}

Linear MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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

2

How do I get a Linear API key?

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

3

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.

4

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.

5

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

More Version Control MCP servers