@chykalophia/clickup-mcp-server 3.2.0

package/build/tools/webhook-tools-setup.js

@@ -0,0 +1,304 @@
+import { z } from 'zod';
+import { WebhooksEnhancedClient } from '../clickup-client/webhooks-enhanced.js';
+import { CreateWebhookSchema, UpdateWebhookSchema, WebhookFilterSchema, ValidateWebhookSignatureSchema, ProcessWebhookSchema, WebhookPayloadSchema } from '../schemas/webhook-schemas.js';
+// Create clients
+// const clickUpClient = createClickUpClient();
+const webhooksClient = new WebhooksEnhancedClient(process.env.CLICKUP_API_TOKEN);
+export function setupWebhookTools(server) {
+    // ========================================
+    // WEBHOOK MANAGEMENT OPERATIONS
+    // ========================================
+    server.tool('create_webhook', 'Create a new webhook in a ClickUp workspace. Webhooks allow real-time notifications when events occur.', {
+        workspace_id: z.string().min(1).describe('The ID of the workspace to create the webhook in'),
+        endpoint: z.string().url().describe('The URL endpoint that will receive webhook notifications'),
+        events: z.array(z.enum([
+            'taskCreated', 'taskUpdated', 'taskDeleted', 'taskStatusUpdated',
+            'taskAssigneeUpdated', 'taskDueDateUpdated', 'taskCommentPosted',
+            'taskCommentUpdated', 'taskTimeTracked', 'taskTimeUpdated',
+            'listCreated', 'listUpdated', 'listDeleted',
+            'folderCreated', 'folderUpdated', 'folderDeleted',
+            'spaceCreated', 'spaceUpdated', 'spaceDeleted',
+            'goalCreated', 'goalUpdated', 'goalDeleted', 'goalTargetUpdated'
+        ])).describe('Array of events to subscribe to'),
+        health_check_url: z.string().url().optional().describe('Optional URL for webhook health checks'),
+        secret: z.string().optional().describe('Optional secret for HMAC signature validation')
+    }, async (args) => {
+        try {
+            const request = CreateWebhookSchema.parse(args);
+            const result = await webhooksClient.createWebhook(request);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Webhook created successfully:\n\n${JSON.stringify(result, null, 2)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error creating webhook: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }],
+                isError: true
+            };
+        }
+    });
+    server.tool('get_webhooks', 'Get all webhooks for a workspace with optional filtering by status or event type.', {
+        workspace_id: z.string().min(1).describe('The ID of the workspace to get webhooks from'),
+        status: z.enum(['active', 'inactive']).optional().describe('Filter webhooks by status'),
+        event_type: z.string().optional().describe('Filter webhooks by event type')
+    }, async (args) => {
+        try {
+            const filter = WebhookFilterSchema.parse(args);
+            const result = await webhooksClient.getWebhooks(filter);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Webhooks for workspace ${args.workspace_id}:\n\n${JSON.stringify(result, null, 2)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error getting webhooks: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }],
+                isError: true
+            };
+        }
+    });
+    server.tool('get_webhook', 'Get detailed information about a specific webhook by its ID.', {
+        webhook_id: z.string().min(1).describe('The ID of the webhook to get')
+    }, async (args) => {
+        try {
+            const result = await webhooksClient.getWebhook(args.webhook_id);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Webhook details:\n\n${JSON.stringify(result, null, 2)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error getting webhook: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }],
+                isError: true
+            };
+        }
+    });
+    server.tool('update_webhook', 'Update an existing webhook\'s configuration including endpoint, events, and status.', {
+        webhook_id: z.string().min(1).describe('The ID of the webhook to update'),
+        endpoint: z.string().url().optional().describe('The new URL endpoint for webhook notifications'),
+        events: z.array(z.enum([
+            'taskCreated', 'taskUpdated', 'taskDeleted', 'taskStatusUpdated',
+            'taskAssigneeUpdated', 'taskDueDateUpdated', 'taskCommentPosted',
+            'taskCommentUpdated', 'taskTimeTracked', 'taskTimeUpdated',
+            'listCreated', 'listUpdated', 'listDeleted',
+            'folderCreated', 'folderUpdated', 'folderDeleted',
+            'spaceCreated', 'spaceUpdated', 'spaceDeleted',
+            'goalCreated', 'goalUpdated', 'goalDeleted', 'goalTargetUpdated'
+        ])).optional().describe('New array of events to subscribe to'),
+        health_check_url: z.string().url().optional().describe('New URL for webhook health checks'),
+        secret: z.string().optional().describe('New secret for HMAC signature validation'),
+        status: z.enum(['active', 'inactive']).optional().describe('New status for the webhook')
+    }, async (args) => {
+        try {
+            const request = UpdateWebhookSchema.parse(args);
+            const result = await webhooksClient.updateWebhook(request);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Webhook updated successfully:\n\n${JSON.stringify(result, null, 2)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error updating webhook: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }],
+                isError: true
+            };
+        }
+    });
+    server.tool('delete_webhook', 'Delete a webhook from ClickUp. This will stop all notifications to the webhook endpoint.', {
+        webhook_id: z.string().min(1).describe('The ID of the webhook to delete')
+    }, async (args) => {
+        try {
+            const result = await webhooksClient.deleteWebhook(args.webhook_id);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Webhook deleted successfully: ${JSON.stringify(result, null, 2)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error deleting webhook: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }],
+                isError: true
+            };
+        }
+    });
+    server.tool('get_webhook_event_history', 'Get the event history for a webhook including delivery status and response codes.', {
+        webhook_id: z.string().min(1).describe('The ID of the webhook to get event history for'),
+        limit: z.number().positive().optional().describe('Maximum number of events to return')
+    }, async (args) => {
+        try {
+            const result = await webhooksClient.getWebhookEventHistory(args.webhook_id, args.limit);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Webhook event history:\n\n${JSON.stringify(result, null, 2)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error getting webhook event history: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }],
+                isError: true
+            };
+        }
+    });
+    server.tool('ping_webhook', 'Send a test ping to a webhook endpoint to verify it\'s working correctly.', {
+        webhook_id: z.string().min(1).describe('The ID of the webhook to ping')
+    }, async (args) => {
+        try {
+            const result = await webhooksClient.pingWebhook(args.webhook_id);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Webhook ping result:\n\n${JSON.stringify(result, null, 2)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error pinging webhook: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }],
+                isError: true
+            };
+        }
+    });
+    server.tool('validate_webhook_signature', 'Validate the HMAC signature of a webhook payload to ensure authenticity.', {
+        payload: z.string().describe('The raw webhook payload as a string'),
+        signature: z.string().describe('The signature header from the webhook request'),
+        secret: z.string().describe('The webhook secret used for signature generation')
+    }, async (args) => {
+        try {
+            const request = ValidateWebhookSignatureSchema.parse(args);
+            const isValid = webhooksClient.validateWebhookSignature(request);
+            const result = { valid: isValid };
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Webhook signature validation result:\n\n${JSON.stringify(result, null, 2)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error validating webhook signature: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }],
+                isError: true
+            };
+        }
+    });
+    server.tool('process_webhook', 'Process an incoming webhook payload and extract structured information about the event.', {
+        payload: z.any().describe('The webhook payload object'),
+        validate_signature: z.boolean().default(true).describe('Whether to validate the webhook signature'),
+        signature: z.string().optional().describe('The signature header for validation'),
+        secret: z.string().optional().describe('The webhook secret for signature validation')
+    }, async (args) => {
+        try {
+            // Parse the payload if it's a string
+            let payload = args.payload;
+            if (typeof payload === 'string') {
+                payload = JSON.parse(payload);
+            }
+            const parsedPayload = WebhookPayloadSchema.parse(payload);
+            const request = ProcessWebhookSchema.parse({
+                ...args,
+                payload: parsedPayload
+            });
+            const result = await webhooksClient.processWebhook(request);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Webhook processing result:\n\n${JSON.stringify(result, null, 2)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error processing webhook: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }],
+                isError: true
+            };
+        }
+    });
+    server.tool('get_webhook_stats', 'Get statistics about webhook performance including success rate and response times.', {
+        webhook_id: z.string().min(1).describe('The ID of the webhook to get statistics for'),
+        days: z.number().positive().optional().describe('Number of days to include in statistics (default: 30)')
+    }, async (args) => {
+        try {
+            const result = await webhooksClient.getWebhookStats(args.webhook_id, args.days);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Webhook statistics:\n\n${JSON.stringify(result, null, 2)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error getting webhook statistics: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }],
+                isError: true
+            };
+        }
+    });
+    server.tool('retry_webhook_events', 'Retry failed webhook events for a specific webhook.', {
+        webhook_id: z.string().min(1).describe('The ID of the webhook to retry events for'),
+        event_ids: z.array(z.string()).optional().describe('Optional array of specific event IDs to retry. If not provided, all failed events will be retried.')
+    }, async (args) => {
+        try {
+            const result = await webhooksClient.retryWebhookEvents(args.webhook_id, args.event_ids);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Webhook events retry result:\n\n${JSON.stringify(result, null, 2)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error retrying webhook events: ${error instanceof Error ? error.message : 'Unknown error'}`
+                    }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=webhook-tools-setup.js.map

package/build/tools/webhook-tools-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-tools-setup.js","sourceRoot":"","sources":["../../src/tools/webhook-tools-setup.ts"],"names":[],"mappings":"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"}

package/build/tools/webhook-tools.d.ts

@@ -0,0 +1,4 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { WebhooksEnhancedClient } from '../clickup-client/webhooks-enhanced.js';
+export declare function createWebhookTools(_client: WebhooksEnhancedClient): Tool[];
+export declare function handleWebhookTool(name: string, args: any, client: WebhooksEnhancedClient): Promise<any>;

package/build/tools/webhook-tools.js

@@ -0,0 +1,345 @@
+import { CreateWebhookSchema, UpdateWebhookSchema, WebhookFilterSchema, ValidateWebhookSignatureSchema, ProcessWebhookSchema, WebhookPayloadSchema } from '../schemas/webhook-schemas.js';
+export function createWebhookTools(_client) {
+    return [
+        // Create webhook
+        {
+            name: 'create_webhook',
+            description: 'Create a new webhook in a ClickUp workspace. Webhooks allow real-time notifications when events occur.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    workspace_id: {
+                        type: 'string',
+                        description: 'The ID of the workspace to create the webhook in'
+                    },
+                    endpoint: {
+                        type: 'string',
+                        description: 'The URL endpoint that will receive webhook notifications'
+                    },
+                    events: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: [
+                                'taskCreated', 'taskUpdated', 'taskDeleted', 'taskStatusUpdated',
+                                'taskAssigneeUpdated', 'taskDueDateUpdated', 'taskCommentPosted',
+                                'taskCommentUpdated', 'taskTimeTracked', 'taskTimeUpdated',
+                                'listCreated', 'listUpdated', 'listDeleted',
+                                'folderCreated', 'folderUpdated', 'folderDeleted',
+                                'spaceCreated', 'spaceUpdated', 'spaceDeleted',
+                                'goalCreated', 'goalUpdated', 'goalDeleted', 'goalTargetUpdated'
+                            ]
+                        },
+                        description: 'Array of events to subscribe to'
+                    },
+                    health_check_url: {
+                        type: 'string',
+                        description: 'Optional URL for webhook health checks'
+                    },
+                    secret: {
+                        type: 'string',
+                        description: 'Optional secret for HMAC signature validation'
+                    }
+                },
+                required: ['workspace_id', 'endpoint', 'events']
+            }
+        },
+        // Get webhooks
+        {
+            name: 'get_webhooks',
+            description: 'Get all webhooks for a workspace with optional filtering by status or event type.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    workspace_id: {
+                        type: 'string',
+                        description: 'The ID of the workspace to get webhooks from'
+                    },
+                    status: {
+                        type: 'string',
+                        enum: ['active', 'inactive'],
+                        description: 'Filter webhooks by status'
+                    },
+                    event_type: {
+                        type: 'string',
+                        description: 'Filter webhooks by event type'
+                    }
+                },
+                required: ['workspace_id']
+            }
+        },
+        // Get webhook
+        {
+            name: 'get_webhook',
+            description: 'Get detailed information about a specific webhook by its ID.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    webhook_id: {
+                        type: 'string',
+                        description: 'The ID of the webhook to get'
+                    }
+                },
+                required: ['webhook_id']
+            }
+        },
+        // Update webhook
+        {
+            name: 'update_webhook',
+            description: 'Update an existing webhook\'s configuration including endpoint, events, and status.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    webhook_id: {
+                        type: 'string',
+                        description: 'The ID of the webhook to update'
+                    },
+                    endpoint: {
+                        type: 'string',
+                        description: 'The new URL endpoint for webhook notifications'
+                    },
+                    events: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: [
+                                'taskCreated', 'taskUpdated', 'taskDeleted', 'taskStatusUpdated',
+                                'taskAssigneeUpdated', 'taskDueDateUpdated', 'taskCommentPosted',
+                                'taskCommentUpdated', 'taskTimeTracked', 'taskTimeUpdated',
+                                'listCreated', 'listUpdated', 'listDeleted',
+                                'folderCreated', 'folderUpdated', 'folderDeleted',
+                                'spaceCreated', 'spaceUpdated', 'spaceDeleted',
+                                'goalCreated', 'goalUpdated', 'goalDeleted', 'goalTargetUpdated'
+                            ]
+                        },
+                        description: 'New array of events to subscribe to'
+                    },
+                    health_check_url: {
+                        type: 'string',
+                        description: 'New URL for webhook health checks'
+                    },
+                    secret: {
+                        type: 'string',
+                        description: 'New secret for HMAC signature validation'
+                    },
+                    status: {
+                        type: 'string',
+                        enum: ['active', 'inactive'],
+                        description: 'New status for the webhook'
+                    }
+                },
+                required: ['webhook_id']
+            }
+        },
+        // Delete webhook
+        {
+            name: 'delete_webhook',
+            description: 'Delete a webhook from ClickUp. This will stop all notifications to the webhook endpoint.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    webhook_id: {
+                        type: 'string',
+                        description: 'The ID of the webhook to delete'
+                    }
+                },
+                required: ['webhook_id']
+            }
+        },
+        // Get webhook event history
+        {
+            name: 'get_webhook_event_history',
+            description: 'Get the event history for a webhook including delivery status and response codes.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    webhook_id: {
+                        type: 'string',
+                        description: 'The ID of the webhook to get event history for'
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of events to return'
+                    }
+                },
+                required: ['webhook_id']
+            }
+        },
+        // Ping webhook
+        {
+            name: 'ping_webhook',
+            description: 'Send a test ping to a webhook endpoint to verify it\'s working correctly.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    webhook_id: {
+                        type: 'string',
+                        description: 'The ID of the webhook to ping'
+                    }
+                },
+                required: ['webhook_id']
+            }
+        },
+        // Validate webhook signature
+        {
+            name: 'validate_webhook_signature',
+            description: 'Validate the HMAC signature of a webhook payload to ensure authenticity.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    payload: {
+                        type: 'string',
+                        description: 'The raw webhook payload as a string'
+                    },
+                    signature: {
+                        type: 'string',
+                        description: 'The signature header from the webhook request'
+                    },
+                    secret: {
+                        type: 'string',
+                        description: 'The webhook secret used for signature generation'
+                    }
+                },
+                required: ['payload', 'signature', 'secret']
+            }
+        },
+        // Process webhook
+        {
+            name: 'process_webhook',
+            description: 'Process an incoming webhook payload and extract structured information about the event.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    payload: {
+                        type: 'object',
+                        description: 'The webhook payload object'
+                    },
+                    validate_signature: {
+                        type: 'boolean',
+                        description: 'Whether to validate the webhook signature',
+                        default: true
+                    },
+                    signature: {
+                        type: 'string',
+                        description: 'The signature header for validation'
+                    },
+                    secret: {
+                        type: 'string',
+                        description: 'The webhook secret for signature validation'
+                    }
+                },
+                required: ['payload']
+            }
+        },
+        // Get webhook statistics
+        {
+            name: 'get_webhook_stats',
+            description: 'Get statistics about webhook performance including success rate and response times.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    webhook_id: {
+                        type: 'string',
+                        description: 'The ID of the webhook to get statistics for'
+                    },
+                    days: {
+                        type: 'number',
+                        description: 'Number of days to include in statistics (default: 30)'
+                    }
+                },
+                required: ['webhook_id']
+            }
+        },
+        // Retry webhook events
+        {
+            name: 'retry_webhook_events',
+            description: 'Retry failed webhook events for a specific webhook.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    webhook_id: {
+                        type: 'string',
+                        description: 'The ID of the webhook to retry events for'
+                    },
+                    event_ids: {
+                        type: 'array',
+                        items: {
+                            type: 'string'
+                        },
+                        description: 'Optional array of specific event IDs to retry. If not provided, all failed events will be retried.'
+                    }
+                },
+                required: ['webhook_id']
+            }
+        }
+    ];
+}
+export async function handleWebhookTool(name, args, client) {
+    try {
+        switch (name) {
+            case 'create_webhook': {
+                const request = CreateWebhookSchema.parse(args);
+                return await client.createWebhook(request);
+            }
+            case 'get_webhooks': {
+                const filter = WebhookFilterSchema.parse(args);
+                return await client.getWebhooks(filter);
+            }
+            case 'get_webhook': {
+                const { webhook_id } = args;
+                return await client.getWebhook(webhook_id);
+            }
+            case 'update_webhook': {
+                const request = UpdateWebhookSchema.parse(args);
+                return await client.updateWebhook(request);
+            }
+            case 'delete_webhook': {
+                const { webhook_id } = args;
+                return await client.deleteWebhook(webhook_id);
+            }
+            case 'get_webhook_event_history': {
+                const { webhook_id, limit } = args;
+                return await client.getWebhookEventHistory(webhook_id, limit);
+            }
+            case 'ping_webhook': {
+                const { webhook_id } = args;
+                return await client.pingWebhook(webhook_id);
+            }
+            case 'validate_webhook_signature': {
+                const request = ValidateWebhookSignatureSchema.parse(args);
+                const isValid = client.validateWebhookSignature(request);
+                return { valid: isValid };
+            }
+            case 'process_webhook': {
+                // Parse the payload if it's a string
+                let payload = args.payload;
+                if (typeof payload === 'string') {
+                    payload = JSON.parse(payload);
+                }
+                const parsedPayload = WebhookPayloadSchema.parse(payload);
+                const request = ProcessWebhookSchema.parse({
+                    ...args,
+                    payload: parsedPayload
+                });
+                return await client.processWebhook(request);
+            }
+            case 'get_webhook_stats': {
+                const { webhook_id, days } = args;
+                return await client.getWebhookStats(webhook_id, days);
+            }
+            case 'retry_webhook_events': {
+                const { webhook_id, event_ids } = args;
+                return await client.retryWebhookEvents(webhook_id, event_ids);
+            }
+            default:
+                throw new Error(`Unknown webhook tool: ${name}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Webhook tool error: ${error.message}`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=webhook-tools.js.map