TOOL_NAMING_UPDATE.md•3.18 kB
# ClickUp MCP Server - Tool Naming Update
## Overview
All ClickUp MCP server tools have been renamed with a `clickup_` prefix to prevent naming conflicts with other MCP servers, particularly Task Master MCP server.
## Problem Solved
**Issue**: Tool name conflicts between multiple MCP servers
- ClickUp MCP Server had tools like `get_tasks`, `create_task`, `update_task`
- Task Master MCP Server had similar tools like `get_tasks`, `create_task`, `remove_task`
- When both servers were running simultaneously, AI agents couldn't distinguish which server should handle which tool call
- This led to unintended actions and parameter mismatches
## Solution
**Namespaced Tool Names**: All 170+ ClickUp tools now have the `clickup_` prefix
### Examples of Changes
| Old Tool Name | New Tool Name |
|---------------|---------------|
| `get_workspaces` | `clickup_get_workspaces` |
| `get_tasks` | `clickup_get_tasks` |
| `create_task` | `clickup_create_task` |
| `update_task` | `clickup_update_task` |
| `get_task_details` | `clickup_get_task_details` |
| `create_list` | `clickup_create_list` |
| `get_spaces` | `clickup_get_spaces` |
| `create_checklist` | `clickup_create_checklist` |
| `get_task_comments` | `clickup_get_task_comments` |
| `create_task_comment` | `clickup_create_task_comment` |
## Files Updated
### Tool Files (116 tools renamed)
- `src/tools/task-tools.ts` - 18 tools
- `src/tools/space-tools.ts` - 2 tools
- `src/tools/checklist-tools.ts` - 6 tools
- `src/tools/comment-tools.ts` - 11 tools
- `src/tools/doc-tools-enhanced.ts` - 14 tools
- `src/tools/custom-field-tools.ts` - 15 tools
- `src/tools/time-tracking-tools.ts` - 10 tools
- `src/tools/goals-tools.ts` - 12 tools
- `src/tools/webhook-tools-setup.ts` - 11 tools
- `src/tools/views-tools-setup.ts` - 13 tools
- `src/tools/dependencies-tools-setup.ts` - 12 tools
- `src/tools/attachments-tools-setup.ts` - 14 tools
- `src/tools/chat-tools.ts` - 24 tools
- `src/tools/helper-tools.ts` - 5 tools
### Documentation Updated
- `README.md` - Updated all tool examples and documentation
- Added new section explaining the naming convention
## Benefits
1. **Conflict Prevention**: No more ambiguity about which server handles which tool
2. **Clear Identification**: Easy to distinguish ClickUp tools from other services
3. **Better UX**: AI agents can now reliably call the correct tools
4. **Future-Proof**: Prevents conflicts with any future MCP servers
## Migration Guide
If you have existing AI prompts or scripts using the old tool names, update them:
```typescript
// Old usage
get_tasks({ list_id: "123" })
create_task({ list_id: "123", name: "New Task" })
// New usage
clickup_get_tasks({ list_id: "123" })
clickup_create_task({ list_id: "123", name: "New Task" })
```
## Verification
- ✅ All 170+ tools successfully renamed
- ✅ TypeScript compilation successful
- ✅ No breaking changes to functionality
- ✅ Documentation updated
- ✅ Examples updated
## Version Impact
This change is included in version 3.3.0+ of the ClickUp MCP Server.
---
**Date**: 2025-08-22
**Total Tools Renamed**: 116
**Files Modified**: 14 tool files + README.md
**Status**: ✅ Complete