What kind of searching and filtering does Linear MCP server support?

The server supports advanced searching and filtering using Linear's powerful filtering capabilities, including filtering by cycle, team, project, assignee, creator, state, and more, with support for logical operators (and, or) and relative date filtering.

What credentials does it need?

It reads `LINEAR_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Linear MCP Server

Provides access to Linear's issue tracking system through a standardized Model Context Protocol interface.

Local serverstdioTypeScript★ 1

What is the Linear MCP Server?

Provides access to Linear's issue tracking system through a standardized Model Context Protocol interface.

The short version

Create new issues and subissues with label support
Retrieve the list of linear projects
Retrieve the project updates
Create a new project update with health status
Update existing issues with full field modification
Delete issue with validation

What it needs from you

Bun runtime (v1.0.0 or higher) - Linear account with API access

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
create_issue	Input Schema: json { "teamId": "string", "title": "string", "description": "string", "parentId": "string", "status": "string", "priority": "number", "assigneeId": "string \| 'me'", "labelIds": ["string"] }
update_issue	Input Schema: json { "issueId": "string", "title": "string", "description": "string", "status": "string", "priority": "number", "assigneeId": "string \| 'me'", "labelIds": ["string"], "cycleId": "string" }
get_issue	Get detailed information about a specific Linear issue with optional relationships.
search_issues	Search for Linear issues using a query string and advanced filters. Supports Linear's powerful filtering capabilities.
get_teams	Get a list of Linear teams with optional name/key filtering.
delete_issue
create_comment	Input Schema: json { "issueId": "string", "body": "string" }
get_projects	Get a list of Linear projects with optional name filtering and pagination.
get_project_updates	Get project updates for a given project ID with optional filtering parameters.
create_project_update	Input Schema: json { "projectId": "string", "body": "string", "health": "onTrack \| atRisk \| offTrack", "isDiffHidden": "boolean" }

How to install the Linear MCP Server

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": [
        "/absolute/path/to/linear-mcp/build/index.js"
      ],
      "env": {
        "LINEAR_API_KEY": "YOUR_LINEAR_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Bun runtime (v1.0.0 or higher) - Linear account with API access

Variable	Description	Required
LINEAR_API_KEY	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Linear to create issue.”
“Use Linear to update issue.”
“Use Linear to get issue.”

Frequently asked questions

You can create, update, search, and delete Linear issues; manage projects and project updates; add comments with markdown support; and perform type-safe operations using Linear's official SDK.