n8n_list_executions
Retrieve and filter workflow execution history in n8n to monitor performance, track status, and analyze results using pagination and status-based queries.
Instructions
List workflow executions
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of executions to return (default: 20) | |
| cursor | No | Cursor for pagination | |
| workflowId | No | Filter by workflow ID | |
| status | No | Filter by status (success, error, running, warning) |
Implementation Reference
- src/index.ts:144-153 (handler)Handles the 'n8n_list_executions' tool call by invoking the N8nClient's listExecutions method.
case 'n8n_list_executions': { const result = await n8nClient.listExecutions({ limit: (args?.limit as number) || 20, cursor: (args?.cursor as string), workflowId: args?.workflowId as string, status: args?.status as string, }); return { content: [{ type: 'text', text: formatResponse(result) }], }; - src/n8n-client.ts:105-118 (handler)The underlying API implementation that executes the request to fetch workflow executions.
async listExecutions(params?: { limit?: number; cursor?: string; workflowId?: string; status?: string; }): Promise<any> { const queryParams = new URLSearchParams(); if (params?.limit) queryParams.append('limit', params.limit.toString()); if (params?.cursor) queryParams.append('cursor', params.cursor); if (params?.workflowId) queryParams.append('workflowId', params.workflowId); if (params?.status) queryParams.append('status', params.status); const response = await this.client.get(`/executions?${queryParams}`); return response.data; } - src/index.ts:566-578 (schema)Defines the input schema for the 'n8n_list_executions' tool.
{ name: 'n8n_list_executions', description: 'List workflow executions', inputSchema: { type: 'object', properties: { limit: { type: 'number', description: 'Number of executions to return (default: 20)' }, cursor: { type: 'string', description: 'Cursor for pagination' }, workflowId: { type: 'string', description: 'Filter by workflow ID' }, status: { type: 'string', description: 'Filter by status (success, error, running, warning)' }, }, }, },