n8n MCP Server

Instructions

Implementation Reference

• src/tools/executions.ts:42-96 (registration)

  Registration and handler implementation for n8n_list_executions tool.

    // ============ List Executions ============
    server.registerTool(
      'n8n_list_executions',
      {
        title: 'List n8n Executions',
        description: `List workflow executions with optional filtering.
  
  Args:
    - workflowId (string, optional): Filter by workflow ID
    - status (string, optional): Filter by status (error, success, waiting, new, running, canceled, crashed)
    - includeData (boolean): Include full execution data (default: false)
    - projectId (string, optional): Filter by project ID
    - limit (number): Maximum results (default: 100)
    - cursor (string, optional): Pagination cursor
  
  Returns:
    List of executions with id, workflowId, status, mode, timestamps.`,
        inputSchema: ListExecutionsSchema,
        annotations: {
          readOnlyHint: true,
          destructiveHint: false,
          idempotentHint: true,
          openWorldHint: false
        }
      },
      async (params: z.infer<typeof ListExecutionsSchema>) => {
        const queryParams: Record<string, unknown> = {
          limit: params.limit,
          includeData: params.includeData
        };
        if (params.workflowId) queryParams.workflowId = params.workflowId;
        if (params.status) queryParams.status = params.status;
        if (params.projectId) queryParams.projectId = params.projectId;
        if (params.cursor) queryParams.cursor = params.cursor;
        
        const response = await get<N8nPaginatedResponse<N8nExecutionListItem>>('/executions', queryParams);
        
        const formatted = response.data.map(formatExecution).join('\n\n---\n\n');
        const output = {
          count: response.data.length,
          executions: response.data,
          nextCursor: response.nextCursor
        };
        
        let text = `Found ${response.data.length} execution(s):\n\n${formatted}`;
        if (response.nextCursor) {
          text += `\n\n_More results available. Use cursor: ${response.nextCursor}_`;
        }
        
        return {
          content: [{ type: 'text', text }],
          structuredContent: output
        };
      }
    );