Skip to content

Latest commit

 

History

History
310 lines (246 loc) · 21.2 KB

TOOLS.md

File metadata and controls

310 lines (246 loc) · 21.2 KB

MCP Linear Tools

This document provides an overview of all tools implemented in the MCP Linear, as well as recommendations for future development.

Implemented Tools

The following tools are currently implemented and available in the MCP Linear:

User & Organization Tools

Tool Name Description Status
linear_getViewer Get information about the currently authenticated user ✅ Implemented
linear_getOrganization Get information about the current Linear organization ✅ Implemented
linear_getUsers Get a list of users in the Linear organization ✅ Implemented
linear_getLabels Get a list of issue labels from Linear ✅ Implemented

Team Tools

Tool Name Description Status
linear_getTeams Get a list of teams from Linear ✅ Implemented

Project Tools

Tool Name Description Status
linear_getProjects Get a list of projects from Linear ✅ Implemented
linear_createProject Create a new project in Linear ✅ Implemented

Issue Tools

Tool Name Description Status
linear_getIssues Get a list of recent issues from Linear ✅ Implemented
linear_getIssueById Get a specific issue by ID or identifier (e.g., ABC-123) ✅ Implemented
linear_searchIssues Search for issues with various filters ✅ Implemented
linear_createIssue Create a new issue in Linear ✅ Implemented
linear_updateIssue Update an existing issue in Linear ✅ Implemented
linear_createComment Add a comment to an issue in Linear ✅ Implemented
linear_addIssueLabel Add a label to an issue ✅ Implemented
linear_removeIssueLabel Remove a label from an issue ✅ Implemented

Issue Management Tools

Tool Name Description Status
linear_assignIssue Assign an issue to a user ✅ Implemented
linear_subscribeToIssue Subscribe to issue updates 🔄 In Progress
linear_convertIssueToSubtask Convert an issue to a subtask ✅ Implemented
linear_createIssueRelation Create relations between issues (blocks, is blocked by, etc.) 🔄 In Progress
linear_archiveIssue Archive an issue ✅ Implemented
linear_setIssuePriority Set the priority of an issue ✅ Implemented
linear_transferIssue Transfer an issue to another team ✅ Implemented
linear_duplicateIssue Duplicate an issue ✅ Implemented
linear_getIssueHistory Get the history of changes made to an issue ✅ Implemented

Comment Management Tools

Tool Name Description Status
linear_getComments Get all comments for an issue ✅ Implemented

Project Management Tools

Tool Name Description Status
linear_updateProject Update an existing project ✅ Implemented
linear_addIssueToProject Add an existing issue to a project ✅ Implemented
linear_getProjectIssues Get all issues associated with a project ✅ Implemented

Cycle Management Tools

Tool Name Description Status
linear_getCycles Get a list of all cycles ✅ Implemented
linear_getActiveCycle Get the currently active cycle for a team ✅ Implemented
linear_addIssueToCycle Add an issue to a cycle ✅ Implemented

Recommended Future Tools

The following tools are recommended for future implementation to enhance the capabilities of the MCP Linear:

Comment Management

Tool Name Description Priority Status
linear_updateComment Update an existing comment Medium 📝 Planned
linear_deleteComment Delete a comment Low 📝 Planned

Project Management

Tool Name Description Priority Status
linear_archiveProject Archive a project Medium 📝 Planned
linear_getProjectUpdates Get updates for a project Medium 📝 Planned
linear_removeIssueFromProject Remove an issue from a project Medium 📝 Planned
linear_getProjectMembers Get members assigned to a project Medium 📝 Planned
linear_addProjectMember Add a member to a project Medium 📝 Planned
linear_removeProjectMember Remove a member from a project Medium 📝 Planned

Initiative Management

Tool Name Description Priority Status
linear_getInitiatives Get a list of initiatives from Linear High 📝 Planned
linear_getInitiativeById Get details of a specific initiative High 📝 Planned
linear_createInitiative Create a new initiative High 📝 Planned
linear_updateInitiative Update an existing initiative Medium 📝 Planned
linear_archiveInitiative Archive an initiative Medium 📝 Planned
linear_addProjectToInitiative Add a project to an initiative High 📝 Planned
linear_removeProjectFromInitiative Remove a project from an initiative Medium 📝 Planned
linear_getInitiativeProjects Get all projects in an initiative High 📝 Planned

Cycle Management

Tool Name Description Priority Status
linear_getCycleById Get details of a specific cycle Medium 📝 Planned
linear_createCycle Create a new cycle Medium 📝 Planned
linear_updateCycle Update an existing cycle Medium 📝 Planned
linear_removeIssueFromCycle Remove an issue from a cycle Medium 📝 Planned
linear_completeCycle Mark a cycle as complete Medium 📝 Planned
linear_getCycleStats Get statistics for a cycle Medium 📝 Planned

Milestone Management

Tool Name Description Priority Status
linear_getMilestones Get a list of milestones Medium 📝 Planned
linear_getMilestoneById Get details of a specific milestone Medium 📝 Planned
linear_createMilestone Create a new milestone Medium 📝 Planned
linear_updateMilestone Update an existing milestone Low 📝 Planned
linear_archiveMilestone Archive a milestone Low 📝 Planned
linear_getMilestoneProjects Get projects associated with a milestone Medium 📝 Planned
linear_addProjectToMilestone Add a project to a milestone Medium 📝 Planned
linear_removeProjectFromMilestone Remove a project from a milestone Low 📝 Planned

Roadmap Tools

Tool Name Description Priority Status
linear_getRoadmaps Get a list of roadmaps Medium 📝 Planned
linear_getRoadmapById Get details of a specific roadmap Medium 📝 Planned
linear_createRoadmap Create a new roadmap Medium 📝 Planned
linear_updateRoadmap Update an existing roadmap Low 📝 Planned
linear_archiveRoadmap Archive a roadmap Low 📝 Planned
linear_getRoadmapItems Get items in a roadmap Medium 📝 Planned
linear_addItemToRoadmap Add an item to a roadmap Medium 📝 Planned
linear_removeItemFromRoadmap Remove an item from a roadmap Low 📝 Planned

Workflow Management

Tool Name Description Priority Status
linear_getWorkflowStates Get all workflow states Medium ✅ Implemented
linear_createWorkflowState Create a new workflow state Low 📝 Planned
linear_updateWorkflowState Update a workflow state Low 📝 Planned
linear_getTeamStates Get workflow states for a specific team Medium 📝 Planned
linear_reorderWorkflowStates Change the order of workflow states Low 📝 Planned

Team Management

Tool Name Description Priority Status
linear_updateTeam Update team settings Medium 📝 Planned
linear_getTeamMemberships Get team memberships Medium 📝 Planned
linear_createTeam Create a new team Medium 📝 Planned
linear_archiveTeam Archive a team Low 📝 Planned
linear_addUserToTeam Add a user to a team Medium 📝 Planned
linear_removeUserFromTeam Remove a user from a team Medium 📝 Planned
linear_updateTeamMembership Update a user's role in a team Medium 📝 Planned
linear_getTeamLabels Get labels for a specific team Medium 📝 Planned
linear_createTeamLabel Create a new label for a team Medium 📝 Planned

Custom Fields

Tool Name Description Priority Status
linear_getCustomFields Get a list of custom fields Medium 📝 Planned
linear_createCustomField Create a new custom field Low 📝 Planned
linear_updateCustomField Update a custom field Low 📝 Planned
linear_getIssueCustomFields Get custom field values for an issue Medium 📝 Planned
linear_updateIssueCustomField Update a custom field value for an issue Medium 📝 Planned
linear_getTeamCustomFields Get custom fields for a specific team Medium 📝 Planned
linear_deleteCustomField Delete a custom field Low 📝 Planned

Issue Templates

Tool Name Description Priority Status
linear_getIssueTemplates Get a list of issue templates Medium 📝 Planned
linear_getIssueTemplateById Get details of a specific issue template Medium 📝 Planned
linear_createIssueTemplate Create a new issue template Medium 📝 Planned
linear_updateIssueTemplate Update an existing issue template Low 📝 Planned
linear_createIssueFromTemplate Create a new issue from a template High 📝 Planned
linear_getTeamTemplates Get templates for a specific team Medium 📝 Planned
linear_archiveTemplate Archive an issue template Low 📝 Planned

Import and Export

Tool Name Description Priority Status
linear_bulkCreateIssues Create multiple issues at once Medium 📝 Planned
linear_exportIssues Export issues to a structured format Low 📝 Planned
linear_importIssues Import issues from a structured format Low 📝 Planned
linear_importCsvData Import data from CSV Low 📝 Planned

Integration Tools

Tool Name Description Priority Status
linear_createWebhook Create a webhook for integration events Low 📝 Planned
linear_getAttachments Get attachments for an issue Medium 📝 Planned
linear_addAttachment Add an attachment to an issue Medium 📝 Planned
linear_getIntegrations Get a list of active integrations Low 📝 Planned
linear_createIntegration Create a new integration Low 📝 Planned
linear_removeIntegration Remove an integration Low 📝 Planned
linear_getWebhooks Get a list of webhooks Low 📝 Planned
linear_deleteWebhook Delete a webhook Low 📝 Planned

Notifications and Subscriptions

Tool Name Description Priority Status
linear_getNotifications Get notifications for the current user Medium 📝 Planned
linear_markNotificationAsRead Mark a notification as read Medium 📝 Planned
linear_getSubscriptions Get subscriptions for the current user Low 📝 Planned
linear_manageSubscription Subscribe or unsubscribe from an entity Low 📝 Planned
linear_markAllNotificationsAsRead Mark all notifications as read Medium 📝 Planned
linear_getUnreadNotificationCount Get count of unread notifications Medium 📝 Planned

Favorites and Pinning

Tool Name Description Priority Status
linear_getFavorites Get a list of user's favorite items Medium 📝 Planned
linear_addToFavorites Add an item to favorites Medium 📝 Planned
linear_removeFromFavorites Remove an item from favorites Medium 📝 Planned
linear_pinIssue Pin an issue to the top of a list Medium 📝 Planned
linear_unpinIssue Unpin an issue Medium 📝 Planned

User Preferences

Tool Name Description Priority Status
linear_getUserPreferences Get user preferences Low 📝 Planned
linear_updateUserPreferences Update user preferences Low 📝 Planned
linear_getUserSettings Get user application settings Low 📝 Planned
linear_updateUserSettings Update user application settings Low 📝 Planned

Views and Filters

Tool Name Description Priority Status
linear_getSavedViews Get user's saved views Medium 📝 Planned
linear_createSavedView Create a new saved view Medium 📝 Planned
linear_updateSavedView Update a saved view Low 📝 Planned
linear_deleteSavedView Delete a saved view Low 📝 Planned
linear_getFavoriteViews Get user's favorite views Medium 📝 Planned

Metrics and Reporting

Tool Name Description Priority Status
linear_getTeamCycles Get information about team cycles Medium 📝 Planned
linear_getCycleIssues Get issues for a specific cycle Medium 📝 Planned
linear_getTeamMetrics Get performance metrics for a team Low 📝 Planned
linear_getIssueAnalytics Get analytics for issues (cycle time, etc.) Medium 📝 Planned
linear_generateReport Generate a custom report Low 📝 Planned
linear_getVelocityMetrics Get team velocity metrics Medium 📝 Planned
linear_getCompletionRateMetrics Get completion rate metrics Medium 📝 Planned
linear_getTimeToResolutionMetrics Get time-to-resolution metrics Medium 📝 Planned

Audit and History

Tool Name Description Priority Status
linear_getOrganizationAuditEvents Get audit events for the organization Medium 📝 Planned
linear_getUserAuditEvents Get audit events for a specific user Medium 📝 Planned
linear_getTeamAuditEvents Get audit events for a specific team Medium 📝 Planned
linear_getEntityHistory Get the history of changes for an entity Medium 📝 Planned

API and Authentication

Tool Name Description Priority Status
linear_createApiKey Create a new API key Low 📝 Planned
linear_revokeApiKey Revoke an API key Low 📝 Planned
linear_getApiKeys Get all API keys for the user Low 📝 Planned
linear_revokeUserSessions Revoke all user sessions Low 📝 Planned

Implementation Guide

When implementing new tools, follow these steps:

  1. Add a new tool definition in the appropriate file under src/tools/definitions/
  2. Implement the handler function in src/tools/handlers/
  3. Add any necessary type guards in src/tools/type-guards.ts
  4. Add any required methods to the LinearService class in src/services/linear-service.ts
  5. Register the tool in src/tools/definitions/index.ts
  6. Register the handler in src/tools/handlers/index.ts
  7. Update this document to mark the tool as implemented

Status Legend

  • ✅ Implemented: Tool is fully implemented and tested
  • 🔄 In Progress: Tool is currently being implemented
  • 📝 Planned: Tool is planned for future implementation
  • ❓ Under Consideration: Tool is being considered, but not yet planned