SylphxAI

Linear MCP Server

Community SylphxAI
Updated

Archived: no longer maintained.

Linear MCP Server

A Model Context Protocol (MCP) server for interacting with Linear issues, projects, teams, project milestones and more.

Features

  • List, get, create, and update issues
  • List, get, create, and update projects
  • List and get teams
  • List and get users
  • List and get issue statuses
  • List issue labels
  • Manage project milestones (list, create, update, delete)
  • List issues assigned to the current user

Installation

npm install linear-mcp
# or
yarn add linear-mcp
# or
pnpm add linear-mcp

MCP Host Configuration

Configure your MCP host (e.g., mcp_settings.json) to use npx:

{
  "mcpServers": {
     "linear": {
      "command": "npx",
      "args": [
        "-y",
        "@sylphx/linear-mcp"
      ],
      "env": {
        "LINEAR_API_KEY": ""
      }
    }
  }
}

Available Tools

Issues

  • list_issues: List issues in the user's Linear workspace. Supports filtering by projectMilestoneId.
    • Key Inputs: query (optional string), teamId (optional string), stateId (optional string), assigneeId (optional string), projectMilestoneId (optional string), includeArchived (boolean, default: true), limit (number, default: 50).
    • Output: Returns a list of issue objects with detailed information including state, assignee, and projectMilestone (if associated).
  • get_issue: Retrieve a Linear issue's details by ID, including attachments and projectMilestone information.
    • Key Inputs: id (string).
    • Output: Returns a single issue object with its relations, including detailed projectMilestone information if associated.
  • create_issue: Create a new Linear issue. Can optionally associate with a projectMilestoneId.
    • Key Inputs: title (string), teamId (string), description (optional string), priority (optional number), projectId (optional string), stateId (optional string), assigneeId (optional string), labelIds (optional array of strings), dueDate (optional string), projectMilestoneId (optional string).
    • Output: Returns a simplified issue object for the created issue, including projectMilestone information if associated.
  • update_issue: Update an existing Linear issue. Can associate/disassociate with a projectMilestoneId (string or null).
    • Key Inputs: id (string), title (optional string), description (optional string), priority (optional number), projectId (optional string), stateId (optional string), assigneeId (optional string), labelIds (optional array of strings), dueDate (optional string), projectMilestoneId (optional string or null).
    • Output: Returns a simplified issue object for the updated issue, including projectMilestone information if associated.
  • list_comments: Retrieve comments for a Linear issue by ID.
  • create_comment: Create a comment on a Linear issue by ID.
  • get_issue_git_branch_name: Retrieve the branch name for a Linear issue by ID.

Projects

  • list_projects: List projects in the user's Linear workspace.
  • get_project: Retrieve details of a specific project in Linear.
  • create_project: Create a new project in Linear.
  • update_project: Update an existing Linear project.

Project Milestones

  • list_project_milestones: List all project milestones for a given project.
    • Key Inputs: projectId (string).
    • Output: Returns a list of project milestone objects.
  • create_project_milestone: Create a new project milestone.
    • Key Inputs: projectId (string), name (string), description (optional string), targetDate (optional ISO date string).
    • Output: Returns the created project milestone object.
  • update_project_milestone: Update an existing project milestone.
    • Key Inputs: milestoneId (string), name (optional string), description (optional string), targetDate (optional ISO date string).
    • Output: Returns the updated project milestone object.
  • delete_project_milestone: Delete a project milestone.
    • Key Inputs: milestoneId (string).
    • Output: Returns a confirmation of deletion.

Teams

  • list_teams: List teams in the user's Linear workspace.
  • get_team: Retrieve details of a specific Linear team.

Users

  • list_users: Retrieve users in the Linear workspace.
  • get_user: Retrieve details of a specific Linear user.

Issue Statuses

  • list_issue_statuses: List available issues statuses in a Linear team.
  • get_issue_status: Retrieve details of a specific issue status in Linear by name or ID.

Labels

  • list_issue_labels: List available issue labels in a Linear team.

My Issues

  • list_my_issues: List issues assigned to the current user.

License

ISC

MCP Server ยท Populars

MCP Server ยท New

    kitfunso

    Hippo

    One memory for every agent you'll ever use. Hippo writes what you teach a coding agent into a store in your repo, and your other agents read that same store.

    Community kitfunso
    Avazbek22

    DevProjex: MCP / GUI / CLI / TUI all in one

    Repomix alternative with up to 40% fewer tokens. Turn any codebase or Git repository into safe, token-efficient context for LLM and coding agents like Claude Code, Codex, and Cursor. GUI, TUI, CLI, and a read-only RAG MCP server with Live Context, agent journal, Smart Ignore, secret/PII redaction, and code compression. Windows, macOS, Linux.

    Community Avazbek22
    membaseai

    Membase

    Memory layer for AI agents โ€” SDKs, CLI and MCP server for Membase

    Community membaseai
    dosco

    DeepORG โ€” One AI Agent for Your Whole Organization

    DeepORG (formerly GraphJin) โ€” one AI agent for your whole organization: databases, APIs, files, and code over MCP

    Community dosco
    scumble-app

    Scumble

    Free, open-source desktop editor for AI inpainting: select, prompt, get a colour-matched layer. FLUX 3 Image, FLUX.2, GPT Image, Nano Banana, Seedream and Qwen through your API key or your own ComfyUI. Layers, PSD export, MCP.

    Community scumble-app