# Changelog
All notable changes to the MCP Linear.app Server will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
### Fixed
- **Custom View Filters**: Fixed custom view filters not being returned in API responses
- Added `filters` field to `formatCustomView` method
- Updated `createCustomView` and `updateCustomView` to only send defined optional fields
- Filters are now properly stored and retrieved from Linear API
- Added comprehensive [Custom View Filters Guide](./CUSTOM_VIEW_FILTERS.md)
### Added
- **Team Management**: Comprehensive team creation and configuration
- `linear_get_team`: Get detailed team information including settings and metadata
- `linear_create_team`: Create new teams with custom keys, icons, colors, and settings
- `linear_update_team`: Update team properties (name, key, description, icon, color, timezone, privacy)
- Support for team icons (emojis), colors, timezones, and privacy settings
- Full team metadata including creation and update timestamps
- **Comprehensive Cycle Management**: Complete cycle/sprint lifecycle management
- `linear_get_cycle`: Get detailed cycle information by ID
- `linear_update_cycle`: Update cycle properties (name, description, dates)
- `linear_archive_cycle`: Archive completed or obsolete cycles
- `linear_unarchive_cycle`: Restore archived cycles
- Added `cycleId` parameter to `linear_create_issue` and `linear_update_issue` for assigning issues to cycles
- **Custom View Management**: Complete custom view lifecycle management
- `linear_list_custom_views`: List all saved custom views
- `linear_create_custom_view`: Create new custom views with issue filters
- `linear_update_custom_view`: Update custom view properties and filters
- `linear_get_custom_view`: Get detailed custom view information
- `linear_delete_custom_view`: Delete custom views
- Support for custom icons, colors, and descriptions
- Shared views across organization
- Team and project association
- Flexible JSON-based filter configuration
- **Enhanced Project Management**: Complete project lifecycle management
- `linear_create_project`: Create new projects with full configuration (teams, members, dates, priority)
- `linear_update_project`: Update all project fields including state transitions
- `linear_get_project`: Get detailed project information with team and member details
- `linear_archive_project`: Archive completed or obsolete projects
- `linear_unarchive_project`: Restore archived projects
- Support for project colors, icons, priorities, and markdown content
- Multi-team project support with team associations
- Project member and lead management
- **Parent Label Filtering**: Automatic detection and filtering of parent/group labels
- The server now validates labels before creating/updating issues
- Parent labels (which cannot be assigned to issues) are automatically filtered out
- Clear warning messages when parent labels are skipped
- Enhanced `linear_list_labels` to show label hierarchy with `isParent`, `parentName`, and `childrenNames` fields
### Changed
- **Improved Project Formatting**: Enhanced project response format
- Projects now include full team details (id, name, key)
- Lead information includes email address
- Added priority, color, icon, and URL fields
- Added createdAt and updatedAt timestamps
- **Improved Error Messages**: More helpful error messages for parent label errors
- Errors now explicitly guide users to use child labels instead
- Error messages include the problematic label name
- Suggests using `linear_list_labels` to find valid labels
### Fixed
- **Parent Label Error**: Fixed "MCP error -32603: LabelIds contain parent labels" issue
- Previously, assigning a parent label would cause a cryptic error
- Now parent labels are automatically filtered with clear warnings
- Users can continue their workflow without manual intervention
## [1.0.0] - 2024-01-31
### Added
- Initial release with 15 MCP tools for Linear.app integration
- Issue management (create, update, list, search, get, assign, comment)
- Team and workflow state listing
- Basic project listing
- Cycle/sprint management (create, list)
- Label management (create, list)
- User listing
- Comprehensive Zod schema validation
- Type-safe TypeScript implementation
- ES module support with Bun runtime
- Full documentation suite (README, API_REFERENCE, QUICK_START, DEPLOYMENT, DEVELOPMENT)
### Technical Details
- Built with @modelcontextprotocol/sdk
- Uses @linear/sdk for Linear API integration
- Zod validation for all inputs
- Async/await error handling
- JSON serialization of Linear objects
- MCP stdio transport protocol
---
## Future Enhancements
Planned features for future releases:
### v1.1.0
- Comments listing and management
- Issue relationships (blocks, relates to)
- Advanced search with multiple filters and sorting
### v1.2.0
- Milestones management
- Custom fields support
- Time tracking integration
### v1.3.0
- Webhooks integration
- Real-time updates
- Notifications access
### v2.0.0
- Bulk operations
- Issue attachments
- Custom views and saved filters
- Advanced label hierarchy management
---
## Version History
- **v1.0.0**: Initial MVP release with core Linear operations
- **Unreleased**: Parent label filtering and improved error handling
