@chykalophia/clickup-mcp-server 3.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (211) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +467 -0
  3. package/bin/clickup-mcp-server-ai.js +9 -0
  4. package/bin/clickup-mcp-server-basic.js +9 -0
  5. package/bin/clickup-mcp-server-efficiency.js +9 -0
  6. package/bin/clickup-mcp-server-enhanced.js +9 -0
  7. package/build/app.d.ts +1 -0
  8. package/build/app.js +2 -0
  9. package/build/app.js.map +1 -0
  10. package/build/clickup-client/attachments-enhanced.d.ts +128 -0
  11. package/build/clickup-client/attachments-enhanced.js +212 -0
  12. package/build/clickup-client/attachments-enhanced.js.map +1 -0
  13. package/build/clickup-client/auth.d.ts +254 -0
  14. package/build/clickup-client/auth.js +105 -0
  15. package/build/clickup-client/auth.js.map +1 -0
  16. package/build/clickup-client/chat-enhanced.d.ts +141 -0
  17. package/build/clickup-client/chat-enhanced.js +196 -0
  18. package/build/clickup-client/chat-enhanced.js.map +1 -0
  19. package/build/clickup-client/checklists.d.ts +87 -0
  20. package/build/clickup-client/checklists.js +63 -0
  21. package/build/clickup-client/checklists.js.map +1 -0
  22. package/build/clickup-client/comments-enhanced.d.ts +176 -0
  23. package/build/clickup-client/comments-enhanced.js +230 -0
  24. package/build/clickup-client/comments-enhanced.js.map +1 -0
  25. package/build/clickup-client/comments.d.ts +173 -0
  26. package/build/clickup-client/comments.js +312 -0
  27. package/build/clickup-client/comments.js.map +1 -0
  28. package/build/clickup-client/custom-fields-enhanced.d.ts +286 -0
  29. package/build/clickup-client/custom-fields-enhanced.js +416 -0
  30. package/build/clickup-client/custom-fields-enhanced.js.map +1 -0
  31. package/build/clickup-client/dependencies-enhanced.d.ts +144 -0
  32. package/build/clickup-client/dependencies-enhanced.js +142 -0
  33. package/build/clickup-client/dependencies-enhanced.js.map +1 -0
  34. package/build/clickup-client/docs-enhanced.d.ts +176 -0
  35. package/build/clickup-client/docs-enhanced.js +374 -0
  36. package/build/clickup-client/docs-enhanced.js.map +1 -0
  37. package/build/clickup-client/docs.d.ts +84 -0
  38. package/build/clickup-client/docs.js +156 -0
  39. package/build/clickup-client/docs.js.map +1 -0
  40. package/build/clickup-client/folders.d.ts +62 -0
  41. package/build/clickup-client/folders.js +53 -0
  42. package/build/clickup-client/folders.js.map +1 -0
  43. package/build/clickup-client/goals-enhanced.d.ts +163 -0
  44. package/build/clickup-client/goals-enhanced.js +309 -0
  45. package/build/clickup-client/goals-enhanced.js.map +1 -0
  46. package/build/clickup-client/index.d.ts +16 -0
  47. package/build/clickup-client/index.js +61 -0
  48. package/build/clickup-client/index.js.map +1 -0
  49. package/build/clickup-client/lists.d.ts +105 -0
  50. package/build/clickup-client/lists.js +108 -0
  51. package/build/clickup-client/lists.js.map +1 -0
  52. package/build/clickup-client/secure-client.d.ts +88 -0
  53. package/build/clickup-client/secure-client.js +275 -0
  54. package/build/clickup-client/secure-client.js.map +1 -0
  55. package/build/clickup-client/spaces.d.ts +58 -0
  56. package/build/clickup-client/spaces.js +28 -0
  57. package/build/clickup-client/spaces.js.map +1 -0
  58. package/build/clickup-client/tasks.d.ts +161 -0
  59. package/build/clickup-client/tasks.js +99 -0
  60. package/build/clickup-client/tasks.js.map +1 -0
  61. package/build/clickup-client/time-tracking-enhanced.d.ts +153 -0
  62. package/build/clickup-client/time-tracking-enhanced.js +292 -0
  63. package/build/clickup-client/time-tracking-enhanced.js.map +1 -0
  64. package/build/clickup-client/views-enhanced.d.ts +149 -0
  65. package/build/clickup-client/views-enhanced.js +210 -0
  66. package/build/clickup-client/views-enhanced.js.map +1 -0
  67. package/build/clickup-client/webhooks-enhanced.d.ts +119 -0
  68. package/build/clickup-client/webhooks-enhanced.js +169 -0
  69. package/build/clickup-client/webhooks-enhanced.js.map +1 -0
  70. package/build/controllers/lists.controller.d.ts +1 -0
  71. package/build/controllers/lists.controller.js +2 -0
  72. package/build/controllers/lists.controller.js.map +1 -0
  73. package/build/index-efficiency-simple.d.ts +2 -0
  74. package/build/index-efficiency-simple.js +379 -0
  75. package/build/index-efficiency-simple.js.map +1 -0
  76. package/build/index-enhanced-efficiency.d.ts +2 -0
  77. package/build/index-enhanced-efficiency.js +275 -0
  78. package/build/index-enhanced-efficiency.js.map +1 -0
  79. package/build/index-enhanced.d.ts +2 -0
  80. package/build/index-enhanced.js +74 -0
  81. package/build/index-enhanced.js.map +1 -0
  82. package/build/index.d.ts +2 -0
  83. package/build/index.js +77 -0
  84. package/build/index.js.map +1 -0
  85. package/build/resources/checklist-resources.d.ts +2 -0
  86. package/build/resources/checklist-resources.js +102 -0
  87. package/build/resources/checklist-resources.js.map +1 -0
  88. package/build/resources/comment-resources.d.ts +2 -0
  89. package/build/resources/comment-resources.js +152 -0
  90. package/build/resources/comment-resources.js.map +1 -0
  91. package/build/resources/doc-resources.d.ts +2 -0
  92. package/build/resources/doc-resources.js +77 -0
  93. package/build/resources/doc-resources.js.map +1 -0
  94. package/build/resources/folder-resources.d.ts +2 -0
  95. package/build/resources/folder-resources.js +160 -0
  96. package/build/resources/folder-resources.js.map +1 -0
  97. package/build/resources/list-resources.d.ts +2 -0
  98. package/build/resources/list-resources.js +104 -0
  99. package/build/resources/list-resources.js.map +1 -0
  100. package/build/resources/space-resources.d.ts +2 -0
  101. package/build/resources/space-resources.js +104 -0
  102. package/build/resources/space-resources.js.map +1 -0
  103. package/build/resources/task-resources.d.ts +2 -0
  104. package/build/resources/task-resources.js +57 -0
  105. package/build/resources/task-resources.js.map +1 -0
  106. package/build/routes/lists.routes.d.ts +1 -0
  107. package/build/routes/lists.routes.js +2 -0
  108. package/build/routes/lists.routes.js.map +1 -0
  109. package/build/schemas/attachments-schemas.d.ts +201 -0
  110. package/build/schemas/attachments-schemas.js +250 -0
  111. package/build/schemas/attachments-schemas.js.map +1 -0
  112. package/build/schemas/chat-schemas.d.ts +478 -0
  113. package/build/schemas/chat-schemas.js +173 -0
  114. package/build/schemas/chat-schemas.js.map +1 -0
  115. package/build/schemas/custom-field-schemas.d.ts +1617 -0
  116. package/build/schemas/custom-field-schemas.js +384 -0
  117. package/build/schemas/custom-field-schemas.js.map +1 -0
  118. package/build/schemas/dependencies-schemas.d.ts +274 -0
  119. package/build/schemas/dependencies-schemas.js +176 -0
  120. package/build/schemas/dependencies-schemas.js.map +1 -0
  121. package/build/schemas/document-schemas.d.ts +433 -0
  122. package/build/schemas/document-schemas.js +168 -0
  123. package/build/schemas/document-schemas.js.map +1 -0
  124. package/build/schemas/goals-schemas.d.ts +961 -0
  125. package/build/schemas/goals-schemas.js +293 -0
  126. package/build/schemas/goals-schemas.js.map +1 -0
  127. package/build/schemas/time-tracking-schemas.d.ts +741 -0
  128. package/build/schemas/time-tracking-schemas.js +234 -0
  129. package/build/schemas/time-tracking-schemas.js.map +1 -0
  130. package/build/schemas/views-schemas.d.ts +1168 -0
  131. package/build/schemas/views-schemas.js +221 -0
  132. package/build/schemas/views-schemas.js.map +1 -0
  133. package/build/schemas/webhook-schemas.d.ts +1127 -0
  134. package/build/schemas/webhook-schemas.js +137 -0
  135. package/build/schemas/webhook-schemas.js.map +1 -0
  136. package/build/services/lists.service.d.ts +1 -0
  137. package/build/services/lists.service.js +2 -0
  138. package/build/services/lists.service.js.map +1 -0
  139. package/build/tools/attachments-tools-setup.d.ts +2 -0
  140. package/build/tools/attachments-tools-setup.js +387 -0
  141. package/build/tools/attachments-tools-setup.js.map +1 -0
  142. package/build/tools/chat-tools-enhanced.d.ts +5 -0
  143. package/build/tools/chat-tools-enhanced.js +396 -0
  144. package/build/tools/chat-tools-enhanced.js.map +1 -0
  145. package/build/tools/chat-tools.d.ts +2 -0
  146. package/build/tools/chat-tools.js +614 -0
  147. package/build/tools/chat-tools.js.map +1 -0
  148. package/build/tools/checklist-tools.d.ts +2 -0
  149. package/build/tools/checklist-tools.js +139 -0
  150. package/build/tools/checklist-tools.js.map +1 -0
  151. package/build/tools/comment-tools.d.ts +2 -0
  152. package/build/tools/comment-tools.js +295 -0
  153. package/build/tools/comment-tools.js.map +1 -0
  154. package/build/tools/custom-field-tools.d.ts +2 -0
  155. package/build/tools/custom-field-tools.js +578 -0
  156. package/build/tools/custom-field-tools.js.map +1 -0
  157. package/build/tools/dependencies-tools-setup.d.ts +2 -0
  158. package/build/tools/dependencies-tools-setup.js +319 -0
  159. package/build/tools/dependencies-tools-setup.js.map +1 -0
  160. package/build/tools/doc-tools-enhanced.d.ts +2 -0
  161. package/build/tools/doc-tools-enhanced.js +417 -0
  162. package/build/tools/doc-tools-enhanced.js.map +1 -0
  163. package/build/tools/doc-tools.d.ts +2 -0
  164. package/build/tools/doc-tools.js +109 -0
  165. package/build/tools/doc-tools.js.map +1 -0
  166. package/build/tools/goals-tools.d.ts +2 -0
  167. package/build/tools/goals-tools.js +422 -0
  168. package/build/tools/goals-tools.js.map +1 -0
  169. package/build/tools/helper-tools.d.ts +2 -0
  170. package/build/tools/helper-tools.js +363 -0
  171. package/build/tools/helper-tools.js.map +1 -0
  172. package/build/tools/space-tools.d.ts +2 -0
  173. package/build/tools/space-tools.js +45 -0
  174. package/build/tools/space-tools.js.map +1 -0
  175. package/build/tools/task-tools.d.ts +2 -0
  176. package/build/tools/task-tools.js +415 -0
  177. package/build/tools/task-tools.js.map +1 -0
  178. package/build/tools/time-tracking-tools.d.ts +2 -0
  179. package/build/tools/time-tracking-tools.js +329 -0
  180. package/build/tools/time-tracking-tools.js.map +1 -0
  181. package/build/tools/views-tools-setup.d.ts +2 -0
  182. package/build/tools/views-tools-setup.js +358 -0
  183. package/build/tools/views-tools-setup.js.map +1 -0
  184. package/build/tools/webhook-tools-setup.d.ts +2 -0
  185. package/build/tools/webhook-tools-setup.js +304 -0
  186. package/build/tools/webhook-tools-setup.js.map +1 -0
  187. package/build/tools/webhook-tools.d.ts +4 -0
  188. package/build/tools/webhook-tools.js +345 -0
  189. package/build/tools/webhook-tools.js.map +1 -0
  190. package/build/utils/clickup-comment-formatter.d.ts +124 -0
  191. package/build/utils/clickup-comment-formatter.js +504 -0
  192. package/build/utils/clickup-comment-formatter.js.map +1 -0
  193. package/build/utils/context-aware-suggestions.d.ts +45 -0
  194. package/build/utils/context-aware-suggestions.js +360 -0
  195. package/build/utils/context-aware-suggestions.js.map +1 -0
  196. package/build/utils/error-handling.d.ts +140 -0
  197. package/build/utils/error-handling.js +392 -0
  198. package/build/utils/error-handling.js.map +1 -0
  199. package/build/utils/markdown-styling.d.ts +40 -0
  200. package/build/utils/markdown-styling.js +344 -0
  201. package/build/utils/markdown-styling.js.map +1 -0
  202. package/build/utils/markdown.d.ts +54 -0
  203. package/build/utils/markdown.js +243 -0
  204. package/build/utils/markdown.js.map +1 -0
  205. package/build/utils/security.d.ts +79 -0
  206. package/build/utils/security.js +303 -0
  207. package/build/utils/security.js.map +1 -0
  208. package/build/utils/tool-efficiency.d.ts +59 -0
  209. package/build/utils/tool-efficiency.js +247 -0
  210. package/build/utils/tool-efficiency.js.map +1 -0
  211. package/package.json +130 -0
@@ -0,0 +1,247 @@
1
+ /**
2
+ * Tool Efficiency and Metadata System
3
+ * Provides intelligent tool suggestions and efficiency hints for better AI decision making
4
+ */
5
+ /**
6
+ * Tool categories and their efficiency characteristics
7
+ */
8
+ export const TOOL_CATEGORIES = {
9
+ // Direct action tools - most efficient for specific tasks
10
+ DIRECT: {
11
+ chat: ['create_chat_view_comment', 'get_chat_view_comments'],
12
+ tasks: ['get_task_details', 'create_task', 'update_task'],
13
+ search: ['search_docs', 'search_attachments'],
14
+ bulk: ['bulk_set_custom_field_values', 'bulk_attachment_operations']
15
+ },
16
+ // Hierarchical navigation tools - use when direct tools aren't available
17
+ HIERARCHICAL: {
18
+ navigation: ['get_workspaces', 'get_spaces', 'get_lists', 'get_views'],
19
+ discovery: ['get_folders', 'get_folderless_lists']
20
+ },
21
+ // Helper tools for complex workflows
22
+ HELPERS: {
23
+ suggestions: ['suggest_tools_for_task', 'find_chat_channels', 'search_views_by_name'],
24
+ validation: ['validate_custom_field_value', 'check_dependency_conflicts']
25
+ }
26
+ };
27
+ /**
28
+ * Comprehensive tool metadata registry
29
+ */
30
+ export const TOOL_METADATA = {
31
+ // Chat Tools
32
+ 'create_chat_view_comment': {
33
+ name: 'create_chat_view_comment',
34
+ category: 'core',
35
+ efficiency: 'direct',
36
+ use_cases: ['send_message_to_chat', 'post_announcement', 'team_communication'],
37
+ alternatives: ['create_list_comment', 'create_task_comment'],
38
+ efficiency_hint: 'Most direct way to post to chat channels. Use find_chat_channels if you need to discover chat view IDs first.',
39
+ prerequisites: ['chat_view_id'],
40
+ related_tools: ['get_chat_view_comments', 'find_chat_channels'],
41
+ performance_impact: 'low'
42
+ },
43
+ 'get_chat_view_comments': {
44
+ name: 'get_chat_view_comments',
45
+ category: 'core',
46
+ efficiency: 'direct',
47
+ use_cases: ['read_chat_history', 'get_recent_messages'],
48
+ alternatives: ['get_task_comments', 'get_list_comments'],
49
+ efficiency_hint: 'Direct way to read chat messages. More efficient than navigating workspace hierarchy.',
50
+ prerequisites: ['chat_view_id'],
51
+ related_tools: ['create_chat_view_comment', 'find_chat_channels'],
52
+ performance_impact: 'low'
53
+ },
54
+ // Navigation Tools (less efficient)
55
+ 'get_workspaces': {
56
+ name: 'get_workspaces',
57
+ category: 'core',
58
+ efficiency: 'hierarchical',
59
+ use_cases: ['workspace_discovery', 'initial_setup'],
60
+ alternatives: [],
61
+ efficiency_hint: 'Use only when you need to discover workspaces. Avoid if you already know workspace structure.',
62
+ performance_impact: 'medium'
63
+ },
64
+ 'get_spaces': {
65
+ name: 'get_spaces',
66
+ category: 'core',
67
+ efficiency: 'hierarchical',
68
+ use_cases: ['space_discovery', 'workspace_exploration'],
69
+ alternatives: ['search_views_by_name'],
70
+ efficiency_hint: 'Use when you need to explore workspace structure. Consider search tools for specific items.',
71
+ prerequisites: ['workspace_id'],
72
+ related_tools: ['get_views', 'get_lists'],
73
+ performance_impact: 'medium'
74
+ },
75
+ 'get_views': {
76
+ name: 'get_views',
77
+ category: 'core',
78
+ efficiency: 'hierarchical',
79
+ use_cases: ['view_discovery', 'find_chat_channels'],
80
+ alternatives: ['find_chat_channels', 'search_views_by_name'],
81
+ efficiency_hint: 'Use with type filter for efficiency. Consider find_chat_channels for chat discovery.',
82
+ prerequisites: ['parent_id', 'parent_type'],
83
+ related_tools: ['create_view', 'update_view'],
84
+ performance_impact: 'medium'
85
+ },
86
+ // Search Tools (most efficient for discovery)
87
+ 'search_docs': {
88
+ name: 'search_docs',
89
+ category: 'search',
90
+ efficiency: 'search',
91
+ use_cases: ['find_documents', 'content_discovery'],
92
+ alternatives: ['get_docs_from_workspace'],
93
+ efficiency_hint: 'Most efficient way to find specific documents. Prefer over workspace navigation.',
94
+ prerequisites: ['workspace_id', 'query'],
95
+ performance_impact: 'low'
96
+ },
97
+ // Task Tools
98
+ 'get_task_details': {
99
+ name: 'get_task_details',
100
+ category: 'core',
101
+ efficiency: 'direct',
102
+ use_cases: ['task_information', 'task_analysis'],
103
+ alternatives: ['get_tasks'],
104
+ efficiency_hint: 'Most direct way to get task information when you have task ID.',
105
+ prerequisites: ['task_id'],
106
+ related_tools: ['update_task', 'create_task_comment'],
107
+ performance_impact: 'low'
108
+ },
109
+ 'get_tasks': {
110
+ name: 'get_tasks',
111
+ category: 'core',
112
+ efficiency: 'hierarchical',
113
+ use_cases: ['list_tasks', 'task_discovery'],
114
+ alternatives: ['get_view_tasks', 'search_tasks'],
115
+ efficiency_hint: 'Use when you need all tasks from a list. Consider get_view_tasks for filtered results.',
116
+ prerequisites: ['list_id'],
117
+ related_tools: ['create_task', 'get_task_details'],
118
+ performance_impact: 'medium'
119
+ }
120
+ };
121
+ /**
122
+ * Analyzes a user request and suggests the most efficient tools
123
+ */
124
+ export function suggestToolsForTask(request) {
125
+ const lowerRequest = request.toLowerCase();
126
+ // Chat-related requests
127
+ if (lowerRequest.includes('chat') || lowerRequest.includes('message') || lowerRequest.includes('post')) {
128
+ if (lowerRequest.includes('send') || lowerRequest.includes('post') || lowerRequest.includes('create')) {
129
+ return {
130
+ primary_tools: ['create_chat_view_comment'],
131
+ alternative_tools: ['create_list_comment', 'create_task_comment'],
132
+ efficiency_notes: [
133
+ 'Use create_chat_view_comment for direct chat posting',
134
+ 'If you need to find chat channels, use find_chat_channels first',
135
+ 'Avoid workspace navigation unless absolutely necessary'
136
+ ],
137
+ workflow_hint: 'If you have chat_view_id → create_chat_view_comment. If not → find_chat_channels → create_chat_view_comment'
138
+ };
139
+ }
140
+ if (lowerRequest.includes('read') || lowerRequest.includes('get') || lowerRequest.includes('history')) {
141
+ return {
142
+ primary_tools: ['get_chat_view_comments'],
143
+ alternative_tools: ['find_chat_channels'],
144
+ efficiency_notes: [
145
+ 'Use get_chat_view_comments for direct chat reading',
146
+ 'More efficient than navigating workspace hierarchy'
147
+ ],
148
+ workflow_hint: 'If you have chat_view_id → get_chat_view_comments. If not → find_chat_channels → get_chat_view_comments'
149
+ };
150
+ }
151
+ }
152
+ // Task-related requests
153
+ if (lowerRequest.includes('task')) {
154
+ if (lowerRequest.includes('create') || lowerRequest.includes('new')) {
155
+ return {
156
+ primary_tools: ['create_task'],
157
+ alternative_tools: ['create_task_from_template'],
158
+ efficiency_notes: ['Direct task creation is most efficient'],
159
+ workflow_hint: 'create_task with list_id'
160
+ };
161
+ }
162
+ if (lowerRequest.includes('get') || lowerRequest.includes('details') || lowerRequest.includes('info')) {
163
+ return {
164
+ primary_tools: ['get_task_details'],
165
+ alternative_tools: ['get_tasks'],
166
+ efficiency_notes: [
167
+ 'Use get_task_details if you have task_id',
168
+ 'Use get_tasks only if you need to list multiple tasks'
169
+ ],
170
+ workflow_hint: 'Prefer get_task_details over get_tasks when possible'
171
+ };
172
+ }
173
+ }
174
+ // Document-related requests
175
+ if (lowerRequest.includes('doc') || lowerRequest.includes('document')) {
176
+ if (lowerRequest.includes('search') || lowerRequest.includes('find')) {
177
+ return {
178
+ primary_tools: ['search_docs'],
179
+ alternative_tools: ['get_docs_from_workspace'],
180
+ efficiency_notes: ['search_docs is more efficient than workspace navigation'],
181
+ workflow_hint: 'Use search_docs with query instead of browsing workspace'
182
+ };
183
+ }
184
+ }
185
+ // Default suggestion for exploration
186
+ return {
187
+ primary_tools: ['get_workspaces'],
188
+ alternative_tools: ['search_docs', 'find_chat_channels'],
189
+ efficiency_notes: [
190
+ 'Consider using search tools before hierarchical navigation',
191
+ 'Direct tools are always more efficient when you have IDs'
192
+ ],
193
+ workflow_hint: 'Try search/direct tools first, then fall back to workspace navigation'
194
+ };
195
+ }
196
+ /**
197
+ * Finds chat channels efficiently
198
+ */
199
+ export function getChatChannelDiscoveryStrategy() {
200
+ return {
201
+ primary_tools: ['find_chat_channels'],
202
+ alternative_tools: ['get_views'],
203
+ efficiency_notes: [
204
+ 'find_chat_channels is purpose-built for chat discovery',
205
+ 'More efficient than get_workspaces → get_spaces → get_views'
206
+ ],
207
+ workflow_hint: 'Use find_chat_channels instead of hierarchical navigation'
208
+ };
209
+ }
210
+ /**
211
+ * Gets efficiency rating for a tool combination
212
+ */
213
+ export function getEfficiencyRating(tools) {
214
+ const directTools = tools.filter(tool => TOOL_METADATA[tool]?.efficiency === 'direct').length;
215
+ const searchTools = tools.filter(tool => TOOL_METADATA[tool]?.efficiency === 'search').length;
216
+ const hierarchicalTools = tools.filter(tool => TOOL_METADATA[tool]?.efficiency === 'hierarchical').length;
217
+ if (directTools > 0 && hierarchicalTools === 0) {
218
+ return {
219
+ rating: 'excellent',
220
+ suggestions: ['Perfect! Using direct tools for maximum efficiency.']
221
+ };
222
+ }
223
+ if (searchTools > 0 && hierarchicalTools <= 1) {
224
+ return {
225
+ rating: 'good',
226
+ suggestions: ['Good use of search tools. Consider direct tools if you have IDs.']
227
+ };
228
+ }
229
+ if (hierarchicalTools <= 2) {
230
+ return {
231
+ rating: 'fair',
232
+ suggestions: [
233
+ 'Consider using search tools before navigation',
234
+ 'Look for direct tools if you have entity IDs'
235
+ ]
236
+ };
237
+ }
238
+ return {
239
+ rating: 'poor',
240
+ suggestions: [
241
+ 'Too much hierarchical navigation',
242
+ 'Use search tools or direct tools instead',
243
+ 'Consider caching IDs for future direct access'
244
+ ]
245
+ };
246
+ }
247
+ //# sourceMappingURL=tool-efficiency.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-efficiency.js","sourceRoot":"","sources":["../../src/utils/tool-efficiency.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,130 @@
1
+ {
2
+ "name": "@chykalophia/clickup-mcp-server",
3
+ "version": "3.2.0",
4
+ "description": "An intelligent Model Context Protocol server for ClickUp API integration with 170+ tools, AI-powered efficiency optimization, smart tool suggestions, and context-aware workflow recommendations",
5
+ "main": "build/index-enhanced.js",
6
+ "bin": {
7
+ "clickup-mcp-server": "build/index-enhanced.js",
8
+ "clickup-mcp-server-basic": "bin/clickup-mcp-server-basic.js",
9
+ "clickup-mcp-server-enhanced": "bin/clickup-mcp-server-enhanced.js",
10
+ "clickup-mcp-server-efficiency": "bin/clickup-mcp-server-efficiency.js",
11
+ "clickup-mcp-server-ai": "bin/clickup-mcp-server-ai.js"
12
+ },
13
+ "scripts": {
14
+ "build": "tsc",
15
+ "dev": "ts-node --esm src/index.ts",
16
+ "start": "node build/index-enhanced.js",
17
+ "start:enhanced": "node build/index-enhanced.js",
18
+ "start:efficiency": "node build/index-enhanced-efficiency.js",
19
+ "test": "jest",
20
+ "test:watch": "jest --watch",
21
+ "test:coverage": "jest --coverage",
22
+ "test:security": "jest --testPathPattern=security --coverage=false",
23
+ "test:integration": "jest --testPathPattern=integration",
24
+ "test:ci": "jest --ci --coverage --watchAll=false",
25
+ "lint": "eslint src/**/*.ts",
26
+ "lint:fix": "eslint src/**/*.ts --fix",
27
+ "format": "prettier --write \"src/**/*.ts\"",
28
+ "security:audit": "npm audit --audit-level=moderate",
29
+ "security:check": "npm run security:audit && npm run test:security",
30
+ "validate": "npm run test:coverage && npm run security:check",
31
+ "validate-with-lint": "npm run lint && npm run test:coverage && npm run security:check",
32
+ "clean": "rm -rf build coverage test-results .jest-cache",
33
+ "prepare": "npm run build",
34
+ "prepack": "npm run validate",
35
+ "version": "npm run format && git add -A src",
36
+ "postversion": "git push && git push --tags",
37
+ "health": "node -e \"require('./build/utils/error-handling.js').performHealthCheck().then(console.log)\"",
38
+ "docs": "typedoc src --out docs --theme default"
39
+ },
40
+ "repository": {
41
+ "type": "git",
42
+ "url": "git+https://github.com/nsxdavid/clickup-mcp-server.git"
43
+ },
44
+ "keywords": [
45
+ "clickup",
46
+ "mcp",
47
+ "model-context-protocol",
48
+ "ai",
49
+ "assistant",
50
+ "api",
51
+ "server",
52
+ "integration",
53
+ "automation",
54
+ "productivity",
55
+ "project-management",
56
+ "webhooks",
57
+ "time-tracking",
58
+ "goals",
59
+ "dependencies",
60
+ "attachments",
61
+ "views",
62
+ "comprehensive",
63
+ "chat",
64
+ "experimental",
65
+ "messaging",
66
+ "channels",
67
+ "reactions",
68
+ "efficiency",
69
+ "optimization",
70
+ "intelligent",
71
+ "smart-suggestions",
72
+ "context-aware",
73
+ "workflow-optimization",
74
+ "ai-powered"
75
+ ],
76
+ "author": "David Whatley (https://davidwhatley.com)",
77
+ "contributors": [
78
+ "ClickUp MCP Server - Enhanced Contributors"
79
+ ],
80
+ "license": "MIT",
81
+ "bugs": {
82
+ "url": "https://github.com/nsxdavid/clickup-mcp-server/issues"
83
+ },
84
+ "homepage": "https://github.com/nsxdavid/clickup-mcp-server#readme",
85
+ "engines": {
86
+ "node": ">=18.0.0"
87
+ },
88
+ "type": "module",
89
+ "dependencies": {
90
+ "@modelcontextprotocol/sdk": "^1.6.1",
91
+ "axios": "^1.6.2",
92
+ "dotenv": "^16.3.1",
93
+ "express": "^4.18.2",
94
+ "marked": "^16.2.0",
95
+ "open": "^9.1.0",
96
+ "turndown": "^7.2.1",
97
+ "zod": "^3.22.4"
98
+ },
99
+ "devDependencies": {
100
+ "@types/jest": "^29.5.14",
101
+ "@types/marked": "^5.0.2",
102
+ "@types/node": "^18.19.26",
103
+ "@types/turndown": "^5.0.5",
104
+ "@typescript-eslint/eslint-plugin": "^6.21.0",
105
+ "@typescript-eslint/parser": "^6.21.0",
106
+ "eslint": "^8.56.0",
107
+ "jest": "^29.7.0",
108
+ "jest-junit": "^16.0.0",
109
+ "jest-watch-typeahead": "^2.2.2",
110
+ "prettier": "^3.1.1",
111
+ "ts-jest": "^29.4.1",
112
+ "ts-node": "^10.9.2",
113
+ "typedoc": "^0.25.13",
114
+ "typescript": "^5.3.3"
115
+ },
116
+ "files": [
117
+ "build/**/*",
118
+ "bin/**/*",
119
+ "README.md",
120
+ "LICENSE",
121
+ "CHANGELOG.md",
122
+ "COMPREHENSIVE_API_COVERAGE.md",
123
+ "EFFICIENCY_ENHANCEMENT_GUIDE.md",
124
+ "WEBHOOK_PROCESSING_GUIDE.md",
125
+ "WEBHOOK_EXAMPLE.md"
126
+ ],
127
+ "publishConfig": {
128
+ "access": "public"
129
+ }
130
+ }