packetnomad linear mcp

WHAT IT CONNECTS

What packetnomad linear mcp gives an 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