list_executions
Retrieve and monitor n8n workflow execution history to track performance, identify issues, and analyze workflow runs with filtering by workflow ID.
Instructions
List n8n workflow executions
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | ||
| limit | No | ||
| workflowId | No |
Implementation Reference
- src/index.ts:483-486 (handler)The MCP tool handler function for 'list_executions'. It receives arguments, calls the N8nClient's listExecutions method, and formats the response as MCP content.private async handleListExecutions(args: { limit?: number; cursor?: string; workflowId?: string }) { const executions = await this.n8nClient.listExecutions(args); return { content: [{ type: 'text', text: JSON.stringify(jsonSuccess(executions), null, 2) }] }; }
- src/index.ts:195-195 (registration)Registration of the 'list_executions' tool in the ListTools response, including its description and input schema definition.{ name: 'list_executions', description: 'List n8n workflow executions', inputSchema: { type: 'object', properties: { limit: { type: 'number' }, cursor: { type: 'string' }, workflowId: { type: 'string' } } } },
- src/n8n-client.ts:733-741 (helper)The N8nClient helper method that implements the core logic by constructing the API URL parameters and fetching executions from the n8n REST API.async listExecutions(options?: { limit?: number; cursor?: string; workflowId?: string }): Promise<N8nExecutionsListResponse> { const params = new URLSearchParams(); if (options?.limit) params.append('limit', options.limit.toString()); if (options?.cursor) params.append('cursor', options.cursor); if (options?.workflowId) params.append('workflowId', options.workflowId); const url = `/executions${params.toString() ? `?${params.toString()}` : ''}`; const response = await this.api.get<N8nExecutionsListResponse>(url); return response.data; }