Official · MODEL CONTEXT PROTOCOL

packetnomad linear mcp

A Model Context Protocol server for Linear.

WHAT IT CONNECTS

packetnomad linear mcp 为 AI Agent 提供什么

  • 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
  • Self-assign issues using 'me' keyword
  • Advanced search with Linear's powerful filtering capabilities
  • Filter issues by cycle (current, next, previous, or specific cycle by UUID or number)
  • Add comments to issues with markdown support
  • Query Linear issues by ID or key with optional relationships
  • Search issues using custom queries with enhanced metadata
  • Type-safe operations using Linear's official SDK
  • Comprehensive error handling
  • Rate limit handling
  • Clean data transformation
  • Parent/child relationship tracking with team inheritance
  • Label management and synchronization
  • [Bun](https://bun.sh) runtime (v1.0.0 or higher)
  • Linear account with API access
  • Cline: `~/Library/Application Support/claude-code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
  • Claude Desktop: `~/Library/Application Support/Claude/claude_desktop_config.json`
  • Cline: `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
  • Claude Desktop: `%APPDATA%\Claude Desktop\claude_desktop_config.json`
  • Cline: `~/.config/claude-code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
  • Claude Desktop: _sadly doesn't exist yet_
  • String fields: `eq`, `neq`, `in`, `nin`, `contains`, `startsWith`, `endsWith` (plus case-insensitive variants)
  • Number fields: `eq`, `neq`, `lt`, `lte`, `gt`, `gte`, `in`, `nin`
  • Date fields: `eq`, `neq`, `lt`, `lte`, `gt`, `gte` (supports ISO 8601 durations)
  • Built with TypeScript in strict mode
  • Uses Linear's official SDK (@linear/sdk)
  • Uses MCP SDK (@modelcontextprotocol/sdk 1.4.0)
  • Authentication via API tokens
  • Comprehensive error handling
  • Rate limiting considerations
  • Bun runtime for improved performance
  • ESM modules throughout
  • Vite build system
  • Type-safe operations
  • Data cleaning features:
  • Issue mention extraction (ABC-123 format)
  • User mention extraction (@username format)
  • Markdown content cleaning
  • Content optimization for AI context
  • Self-assignment support:
  • Automatic current user resolution
  • 'me' keyword support in create/update operations
  • Efficient user ID caching
  • Advanced search capabilities:
  • Comprehensive filtering with Linear's API
  • Support for all field comparators
  • Relationship filtering
  • Logical operators (and, or)
  • Relative date filtering
  • Filter by assignee/creator (including self)
  • Support for specific user IDs
  • Project filtering by ID or name
  • Efficient query optimization
  • Project management features:
  • Project listing with filtering and pagination
  • Project update creation with health status tracking
  • Project update retrieval with filtering options
  • Network error detection and appropriate messaging
  • HTTP status code handling
  • Detailed error messages with status codes
  • Error details logging to console
  • Input validation for all parameters
  • Label validation and synchronization
  • Safe error propagation through MCP protocol
  • Rate limit detection and handling
  • Authentication error handling
  • Invalid query handling
  • Team inheritance validation for subissues
  • User resolution validation
  • Search filter validation

SECURITY

MCP 收录不等于安全审核

MCP 服务器可能获得模型上下文、凭据、本地文件或调用外部系统的权限。连接 Agent 前,请检查代码、环境变量、网络行为、软件包来源与维护状态。