[New Feature] Add ability to create tags

[DesignMike]

Is it possible to add support to add tags? If possible, to even delete or modify existing tags.

[taazkareem]

Is it possible to add support to add tags? If possible, to even delete or modify existing tags.

Hey Mike, yes that is possible and probably will be implemented sooner than later. I know you have already supported on another feature but let me know if you would want that one prioritized.

I can probably do that for the next version.

[taazkareem]

@DesignMike This is what I plan to do for the next update (you don't have to read all of this but the LLM likes to be specific you know):

MCP ClickUp Tag Support - Development Checklist

Overview

This checklist outlines the steps needed to implement tag support for the MCP ClickUp Server based on the ClickUp API.

ClickUp API Tag-Related Endpoints

From the ClickUp API Reference, the following tag-related endpoints are available:

1. Space Tags

   • GET /space/{space_id}/tags - Get Space Tags
   • POST /space/{space_id}/tag - Create Space Tag
   • PUT /space/{space_id}/tag/{tag_name} - Edit Space Tag
   • DELETE /space/{space_id}/tag/{tag_name} - Delete Space Tag

2. Task Tags

   • POST /task/{task_id}/tag/{tag_name} - Add Tag To Task
   • DELETE /task/{task_id}/tag/{tag_name} - Remove Tag From Task

Implementation Checklist

1. Type Definitions

• Add/update tag-related types in src/services/clickup/types.ts:
  • Define ClickUpTag interface
  • Define request/response interfaces for tag operations
  • Update existing types where necessary

2. ClickUp API Service Implementation

• Create src/services/clickup/tag.ts to implement tag-related API calls:
  • getSpaceTags(spaceId: string) - Get tags in a space
  • createSpaceTag(spaceId: string, tagName: string, tagBg: string, tagFg: string) - Create a new tag
  • updateSpaceTag(spaceId: string, tagName: string, newTag: object) - Update a tag
  • deleteSpaceTag(spaceId: string, tagName: string) - Delete a tag
  • addTagToTask(taskId: string, tagName: string) - Add a tag to a task
  • removeTagFromTask(taskId: string, tagName: string) - Remove a tag from a task

3. Tool Implementations

• Create src/tools/tag.ts with the following functions:
  • getSpaceTags(params: { spaceId: string } | { spaceName: string }) - Get tags in a space
  • createSpaceTag(params: { spaceId?: string, spaceName?: string, tagName: string, tagBg?: string, tagFg?: string }) - Create a new tag
  • updateSpaceTag(params: { spaceId?: string, spaceName?: string, tagName: string, newTagName?: string, tagBg?: string, tagFg?: string }) - Update a tag
  • deleteSpaceTag(params: { spaceId?: string, spaceName?: string, tagName: string }) - Delete a tag
  • addTagToTask(params: { taskId?: string, taskName?: string, listName?: string, tagName: string }) - Add a tag to a task
  • removeTagFromTask(params: { taskId?: string, taskName?: string, listName?: string, tagName: string }) - Remove a tag from a task

4. Integration with Existing Task Tools

• Update src/tools/task/single-operations.ts to handle tags parameter when creating tasks
• Update src/tools/task/bulk-operations.ts to handle tags parameter for bulk operations

5. Testing

• Test each tag-related API endpoint
• Test each tool function
• Test integration with task creation and updates

6. Documentation

• Update tool descriptions to include tag functionality
• Update README.md with tag support information

7. Final Steps

• Code review and refinement
• Update changelog.md with tag support information
• Create PR for review

Implementation Strategy

1. Start with read operations (getSpaceTags)
2. Implement task tag operations (add/remove)
3. Implement space tag management (create/update/delete)
4. Finally, implement integration with task management tools

Priority

1. High: Task tag operations (add/remove tags to tasks)
2. Medium: Space tag operations (get/create/update/delete)

[taazkareem]

Feature Released in v0.6.2! 🎉