getAllTasks
Retrieve enterprise tasks from Mews MCP using filters like IDs, dates, or departments, with pagination support for large datasets.
Instructions
Returns all tasks of the enterprise, filtered by identifiers or other filters. REQUIRED: At least one filter must be provided (TaskIds, DepartmentIds, ServiceOrderIds, CreatedUtc, ClosedUtc, or DeadlineUtc). LIMITATIONS: Date range filters (CreatedUtc, ClosedUtc, DeadlineUtc) have a maximum interval of 3 months and 1 day. Array filters (TaskIds, DepartmentIds, ServiceOrderIds) are limited to 1000 items each. The Limitation parameter with Count is mandatory for pagination.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| TaskIds | No | Filter by specific task IDs | |
| DepartmentIds | No | Filter by department IDs | |
| ServiceOrderIds | No | Filter by service order IDs (reservations or product service orders) | |
| CreatedUtc | No | Date range filter for task creation (max 3 months) | |
| ClosedUtc | No | Date range filter for task closure (max 3 months) | |
| DeadlineUtc | No | Date range filter for task deadlines (max 3 months) | |
| Limitation | Yes | Pagination settings with cursor support |
Implementation Reference
- src/tools/tasks/getAllTasks.ts:106-169 (handler)The main handler function that validates input parameters (date ranges max 3 months, arrays max 1000), calls the Mews API endpoint '/api/connector/v1/tasks/getAll', processes the response, and returns a formatted markdown list of tasks with pagination info.async execute(config: any, args: GetAllTasksParams) { try { // Validate date ranges (max 3 months) const validateDateRange = (range: DateRange | undefined, rangeName: string) => { if (!range || !range.StartUtc || !range.EndUtc) return; const start = new Date(range.StartUtc); const end = new Date(range.EndUtc); const diffMonths = (end.getTime() - start.getTime()) / (1000 * 60 * 60 * 24 * 30); if (diffMonths > 3) { throw new Error(`${rangeName} date range cannot exceed 3 months`); } }; validateDateRange(args.CreatedUtc, 'CreatedUtc'); validateDateRange(args.ClosedUtc, 'ClosedUtc'); validateDateRange(args.DeadlineUtc, 'DeadlineUtc'); // Validate array limits if (args.TaskIds && args.TaskIds.length > 1000) { throw new Error('TaskIds cannot exceed 1000 items'); } if (args.DepartmentIds && args.DepartmentIds.length > 1000) { throw new Error('DepartmentIds cannot exceed 1000 items'); } if (args.ServiceOrderIds && args.ServiceOrderIds.length > 1000) { throw new Error('ServiceOrderIds cannot exceed 1000 items'); } const response = await mewsRequest<GetAllTasksParams, GetAllTasksResponse>( config, '/api/connector/v1/tasks/getAll', args ); const taskCount = response.Tasks?.length || 0; const hasMore = !!response.Cursor; return { content: [{ type: 'text', text: `Retrieved ${taskCount} task${taskCount !== 1 ? 's' : ''}${hasMore ? ' (more available)' : ''}:\n\n` + response.Tasks.map((task: Task) => `š **${task.Name}** (${task.State})\n` + ` ID: ${task.Id}\n` + ` Created: ${new Date(task.CreatedUtc).toLocaleString()}\n` + ` Department: ${task.DepartmentId || 'Not assigned'}\n` + ` Service Order: ${task.ServiceOrderId || 'None'}\n` + ` Deadline: ${task.DeadlineUtc ? new Date(task.DeadlineUtc).toLocaleString() : 'Not set'}\n` + ` Description: ${task.Description || 'No description'}\n` ).join('\n') + (hasMore ? `\nš **Pagination:** Use cursor "${response.Cursor}" to get more results` : '') }] }; } catch (error) { return { content: [{ type: 'text', text: `Error retrieving tasks: ${error instanceof Error ? error.message : 'Unknown error occurred'}` }] }; } }
- JSON Schema defining the input parameters for the getAllTasks tool, including optional filters (TaskIds, DepartmentIds, ServiceOrderIds, date ranges) and required Limitation for pagination, with constraints like maxItems:1000 and date range notes.inputSchema: { type: 'object', properties: { TaskIds: { type: 'array', items: { type: 'string' }, maxItems: 1000, description: 'Filter by specific task IDs' }, DepartmentIds: { type: 'array', items: { type: 'string' }, maxItems: 1000, description: 'Filter by department IDs' }, ServiceOrderIds: { type: 'array', items: { type: 'string' }, maxItems: 1000, description: 'Filter by service order IDs (reservations or product service orders)' }, CreatedUtc: { type: 'object', properties: { StartUtc: { type: 'string', description: 'Start of creation date range (ISO 8601)' }, EndUtc: { type: 'string', description: 'End of creation date range (ISO 8601)' } }, description: 'Date range filter for task creation (max 3 months)' }, ClosedUtc: { type: 'object', properties: { StartUtc: { type: 'string', description: 'Start of closure date range (ISO 8601)' }, EndUtc: { type: 'string', description: 'End of closure date range (ISO 8601)' } }, description: 'Date range filter for task closure (max 3 months)' }, DeadlineUtc: { type: 'object', properties: { StartUtc: { type: 'string', description: 'Start of deadline date range (ISO 8601)' }, EndUtc: { type: 'string', description: 'End of deadline date range (ISO 8601)' } }, description: 'Date range filter for task deadlines (max 3 months)' }, Limitation: { type: 'object', properties: { Count: { type: 'number', description: 'Maximum number of tasks to return' }, Cursor: { type: 'string', description: 'Pagination cursor for next page' } }, required: ['Count'], description: 'Pagination settings with cursor support' } }, required: ['Limitation'], additionalProperties: false },
- src/tools/index.ts:153-155 (registration)Registration of the getAllTasksTool in the central allTools array, which is used for MCP tool registry and toolMap lookup.// Task tools getAllTasksTool, addTaskTool,
- src/tools/index.ts:69-69 (registration)Import statement that brings the getAllTasksTool into the index for registration.import { getAllTasksTool } from './tasks/getAllTasks.js';
- src/tools/tasks/getAllTasks.ts:39-42 (schema)TypeScript interface defining the expected API response structure for typing the mewsRequest.interface GetAllTasksResponse { Tasks: Task[]; Cursor?: string; }